> ## 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.

# Set Up the Rankforce Plugin in Your Framer Project

> Add the Rankforce Framer plugin to let AI agents analyze your Framer site and push SEO, GEO & AEO optimizations without touching your code.

The Rankforce Framer plugin brings AI-powered SEO, GEO, and AEO optimization directly into your Framer editor. Once connected, Rankforce agents can read your published pages, surface recommendations alongside your design canvas, and push approved content updates — all without you writing a line of code or leaving the Framer environment.

## Prerequisites

Before adding the plugin, make sure you have the following in place.

<CardGroup cols={2}>
  <Card title="A published Framer site" icon="browser">
    Rankforce reads your live published pages to analyze content. Your site must be published at least once before agents can perform a full crawl.
  </Card>

  <Card title="Rankforce account" icon="key">
    You need an active Rankforce account. A **Growth or Scale plan** is recommended if you want to use Autopilot mode to apply optimizations automatically.
  </Card>

  <Card title="Framer editor access" icon="pencil">
    You must be a project **Editor** or **Owner** in Framer to install plugins. Viewer-role collaborators cannot add or configure plugins.
  </Card>

  <Card title="Browser pop-ups allowed" icon="arrow-up-right-from-square">
    The OAuth authentication flow opens a pop-up window. Make sure your browser allows pop-ups from `framer.com` before you begin.
  </Card>
</CardGroup>

## Add the plugin

<Steps>
  <Step title="Open the Plugins panel">
    Open your Framer project in the Framer editor. Click the **Plugins** icon in the left toolbar — it looks like a puzzle piece. This opens the plugin marketplace panel.
  </Step>

  <Step title="Search for Rankforce">
    Type **Rankforce** into the search field at the top of the Plugins panel. The Rankforce plugin will appear in the results.
  </Step>

  <Step title="Add the plugin">
    Click **Add** next to the Rankforce plugin. Framer installs the plugin and opens it in the right-hand panel of your editor.
  </Step>

  <Step title="Authenticate with your Rankforce account">
    In the Rankforce plugin panel, click **Sign in with Rankforce**. A pop-up window will open prompting you to log in to your Rankforce account. Enter your credentials and click **Authorize**. Once authorized, the pop-up will close and the plugin panel will update to show your connected account.
  </Step>

  <Step title="Select your site">
    If your Rankforce account manages multiple sites, use the site selector dropdown in the plugin panel to choose the site that corresponds to this Framer project. Rankforce will link this Framer project to the selected site in your dashboard.
  </Step>
</Steps>

<Note>
  Rankforce uses OAuth to authenticate with your account — your Rankforce password is never stored inside Framer. You can revoke this access at any time from **Rankforce Dashboard → Settings → Connected Apps**.
</Note>

## What the plugin enables

With the Rankforce Framer plugin connected, the following capabilities become available:

* **Page content analysis** — agents read the text, headings, and metadata of your published Framer pages to identify SEO, GEO, and AEO opportunities.
* **Meta title and description updates** — agents can update the SEO title and meta description set in Framer's **Page Settings** panel for each page.
* **Recommendation delivery** — approved recommendations appear as actionable items in the plugin panel, so you can review and apply them without switching tools.
* **Content copy suggestions** — agents generate rewritten body copy, heading variants, and FAQ content that you can accept and push live in one click.
* **Structured data injection** — the AEO agent can add Schema.org markup to your pages to improve visibility in AI-generated search answers.

<Tip>
  After applying a batch of optimizations, republish your Framer site using the **Publish** button in the editor toolbar. Rankforce will automatically detect the new published version and schedule a verification crawl to confirm the changes went live.
</Tip>

## Framer-specific limitations

Framer's architecture differs from WordPress in a few important ways, and those differences affect how Rankforce operates.

<CardGroup cols={2}>
  <Card title="Publish required for changes to go live" icon="circle-info">
    Rankforce can write optimization data into your Framer project, but the changes don't reach your live site until you click **Publish** in Framer. WordPress optimizations go live immediately on save; Framer requires an explicit publish step.
  </Card>

  <Card title="CMS collections have limited writeback" icon="circle-info">
    Rankforce can read content from Framer CMS collections, but writing back to CMS items is currently limited to title and description fields. Rich-text and component fields within CMS items are read-only from Rankforce's side.
  </Card>

  <Card title="Custom code is not analyzed" icon="circle-info">
    Content rendered via custom code components or embedded iframes is not visible to Rankforce agents. Agents analyze the output of your published pages, not the underlying code components.
  </Card>

  <Card title="Autopilot requires Growth or Scale" icon="circle-info">
    Fully automated optimization without manual approval requires a Growth or Scale plan. On the Starter plan, all recommendations must be manually approved in the plugin panel before being applied.
  </Card>
</CardGroup>

## Troubleshooting

### The plugin won't connect after sign-in

If the plugin panel shows an error or returns to the sign-in screen after you authenticate:

* Confirm that your browser isn't blocking pop-ups from `framer.com`. The OAuth flow relies on a pop-up window completing successfully.
* Try signing out of Rankforce in the plugin panel and signing back in.
* Check that your Rankforce account is active and in good standing at [rankforce.ai](https://rankforce.ai).
* Disconnect and reinstall the plugin: click the three-dot menu on the Rankforce plugin in the Plugins panel, select **Remove**, then add it again.

### Authentication errors ("Invalid session" or "Unauthorized")

These errors typically occur when your Rankforce session has expired or the OAuth token has been revoked:

* Sign out of the plugin panel and sign back in to generate a fresh token.
* If the error persists, navigate to **Rankforce Dashboard → Settings → Connected Apps**, revoke the Framer connection, and re-authenticate via the plugin panel.

### Applied optimizations aren't appearing on the live site

Framer does not auto-publish changes — you must manually publish your project after applying optimizations from the plugin panel:

1. Review all queued optimizations in the Rankforce plugin panel and apply those you want.
2. Click the **Publish** button in the top-right corner of the Framer editor.
3. Wait for Framer to confirm the publish succeeded.
4. Return to your Rankforce dashboard — a verification crawl will run automatically within a few minutes to confirm the changes are live.

<Warning>
  If you close the Framer editor without publishing after applying optimizations, those changes will remain in your unpublished project state. They won't be lost, but they also won't be visible to search engines or Rankforce's verification agent until you publish.
</Warning>