> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rankforce.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Rankforce account settings: profile, API keys, and sites

> Manage your Rankforce account details, API keys, connected sites, notification preferences, and protected pages all from the Settings panel.

The Settings panel is your central hub for configuring how Rankforce works with your sites, your team, and your tools. From here you can update personal account details, generate API keys for plugin connections, manage connected sites, set notification preferences, and define protected pages that agents must never touch. All settings changes take effect immediately unless noted otherwise.

***

## Account details

Your account details control your identity within Rankforce and ensure communications reach the right place. To update any of these fields, go to **Settings → Account**.

| Field        | What it controls                                                                                                                                                              |
| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**     | The display name shown in the dashboard and in team audit logs.                                                                                                               |
| **Email**    | The address used for login, billing receipts, and notification emails. Changing your email triggers a verification message to the new address before the update takes effect. |
| **Password** | Your login password. Rankforce requires a minimum of 12 characters. You must enter your current password before setting a new one.                                            |
| **Timezone** | Used to display optimization timestamps, schedule weekly report emails, and interpret any time-based agent rules you configure.                                               |

<Note>
  If you change your email address, a confirmation link is sent to the new address. Your old email remains active for login until you click that link.
</Note>

***

## API keys

API keys allow the Rankforce WordPress plugin and Framer integration to authenticate securely with your account. Each key is associated with your account and grants the plugin permission to push and pull optimization data on your behalf.

### Generating a new API key

<Steps>
  <Step title="Open API Keys settings">
    Navigate to **Settings → API Keys**.
  </Step>

  <Step title="Click Generate New Key">
    Select **Generate New Key**. Give the key a descriptive label — for example, "WordPress – main site" or "Framer staging" — so you can identify it later.
  </Step>

  <Step title="Copy the key immediately">
    The full API key is only shown once, immediately after generation. Copy it now and paste it into your plugin's settings before closing the dialog. Rankforce does not store the raw key value — only a hashed version is kept for verification.
  </Step>

  <Step title="Paste it into your plugin">
    In your WordPress plugin settings or Framer integration panel, locate the **Rankforce API Key** field and paste the key. Save your plugin settings to complete the connection.
  </Step>
</Steps>

<Warning>
  If you close the key generation dialog without copying your key, you will need to generate a new one. There is no way to retrieve a key after the dialog is dismissed.
</Warning>

### Revoking an API key

If a key is compromised, no longer needed, or you're decommissioning a site, you should revoke it immediately to prevent unauthorized access.

<Steps>
  <Step title="Go to Settings → API Keys">
    The API Keys table lists all active keys with their labels, creation dates, and last-used timestamps.
  </Step>

  <Step title="Revoke the key">
    Click the **⋯** (more options) menu next to the key you want to remove and select **Revoke**. Confirm in the dialog that appears.
  </Step>
</Steps>

Revocation is instant. Any plugin or integration still using that key will immediately lose the ability to communicate with Rankforce until a new key is generated and configured.

***

## Connected sites

The Connected Sites panel shows every WordPress or Framer site linked to your account. The number of sites you can connect depends on your plan: one site on Starter, three on Growth, and unlimited on Scale.

### Viewing your connected sites

Go to **Settings → Sites** to see a table of all connected sites, including each site's URL, platform (WordPress or Framer), connection status, and the date it was connected.

### Adding a new site

<Steps>
  <Step title="Click Add Site">
    In **Settings → Sites**, click **Add Site** in the top-right corner.
  </Step>

  <Step title="Choose your platform">
    Select either **WordPress** or **Framer** depending on where your site is hosted.
  </Step>

  <Step title="Follow the connection guide">
    For WordPress: install the Rankforce plugin from the WordPress plugin directory, then paste your API key into the plugin settings. For Framer: add the Rankforce integration from the Framer integrations panel and authenticate with your API key.
  </Step>

  <Step title="Verify the connection">
    Once the plugin or integration is configured, return to **Settings → Sites**. Your new site should appear with a green **Connected** status within a few seconds.
  </Step>
</Steps>

### Removing a site

<Steps>
  <Step title="Open Connected Sites">
    Go to **Settings → Sites**.
  </Step>

  <Step title="Remove the site">
    Click the **⋯** menu on the site you want to disconnect and select **Remove Site**. Confirm your choice in the dialog.
  </Step>
</Steps>

<Warning>
  Removing a site from Rankforce stops all agent activity for that site immediately. Optimizations that were already applied to your site's content remain in place — Rankforce does not revert published changes when a site is removed. The site's optimization history is retained in your account for 30 days before being permanently deleted.
</Warning>

***

## Notification preferences

Rankforce can send you email notifications to keep you informed without requiring you to log in to check for updates. You can enable or disable each notification type independently in **Settings → Notifications**.

<CardGroup cols={2}>
  <Card title="Pending approval alerts" icon="bell">
    Receive an email whenever new optimizations are queued and waiting for your manual review. Useful on the Starter plan or when autopilot is configured to require approval for certain change types.
  </Card>

  <Card title="Weekly SEO score reports" icon="chart-bar">
    A summary email delivered every Monday morning showing your site's SEO score trend, the number of optimizations applied in the past week, and any items needing attention.
  </Card>
</CardGroup>

To update your preferences, toggle each notification type on or off in **Settings → Notifications** and click **Save Preferences**. Changes apply to future emails only — notifications already queued for delivery are not affected.

***

## Protected pages

Protected pages are URLs that Rankforce's agents are instructed to never read, modify, or include in optimization suggestions. This is a global setting — protected URLs are respected by all agents across all connected sites, regardless of which optimization type is running.

Common use cases for protected pages include privacy policy and terms of service pages that have been reviewed by legal, login and checkout pages where content must stay exactly as tested, and any URL containing sensitive product or pricing information not ready for public optimization.

### Adding a protected page

<Steps>
  <Step title="Go to Protected Pages settings">
    Navigate to **Settings → Protected Pages**.
  </Step>

  <Step title="Click Add URL">
    Select **Add URL** and enter the full URL of the page you want to protect. For example: `https://yoursite.com/checkout`.
  </Step>

  <Step title="Save">
    Click **Add** to confirm. The URL is added to the protected list immediately and agents will skip it from their next run onward.
  </Step>
</Steps>

<Tip>
  You can also protect entire path prefixes by adding a URL ending in `/*`. For example, adding `https://yoursite.com/account/*` protects all pages under the `/account/` path at once.
</Tip>

### Removing a protected page

To remove a URL from the protected list, go to **Settings → Protected Pages**, find the URL in the table, and click **Remove**. Agents will begin including that page in their optimization scope from their next scheduled run.

***

## Danger zone

The Danger Zone section in **Settings → Danger Zone** contains irreversible account actions. Proceed carefully.

<Accordion title="Delete my account">
  Permanently deleting your account removes all of your data from Rankforce — connected sites, optimization history, agent configurations, API keys, team members, and audit logs. This action cannot be undone.

  Before deleting your account:

  * Cancel any active paid subscription in **Settings → Billing** to avoid further charges
  * Note that optimizations already applied to your connected sites will remain live on those sites — deletion does not revert published content changes
  * Remove team members if you are the Owner, or inform them that access will be lost

  To delete your account, click **Delete Account** in **Settings → Danger Zone**, enter your account password to confirm intent, and click **Permanently Delete**. You will be logged out immediately and your data will be queued for deletion within 24 hours.
</Accordion>
