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

# Install on WordPress

> Connect a WordPress site to Agent Analytics with the Growth Mention plugin.

The WordPress plugin reports AI crawler visits and arrivals from AI assistants to your project. It takes about two minutes, and once it's installed it keeps itself up to date.

You'll need to be an **organization admin** in Growth Mention, and able to install plugins on your WordPress site.

<Steps>
  <Step title="Create an ingest key">
    In your project, open **Agent analytics → Integration**. Under **Ingest keys**, give the key a name — the site it's for, like *Main site* — and click **Create key**.

    <Warning>
      Copy the key now. It's shown **only once** — it's stored in a form that can't be displayed again. If you lose it, create a new one.
    </Warning>
  </Step>

  <Step title="Download the plugin">
    On the same page, click **Download for WordPress**. You'll get a `.zip` file — don't unzip it.
  </Step>

  <Step title="Install it">
    In your WordPress admin, go to **Plugins → Add New → Upload Plugin**, choose the file, and click **Install Now**. Then **Activate** it.
  </Step>

  <Step title="Paste in your key">
    Go to **Settings → Agent Analytics** in WordPress and paste the key you copied.
  </Step>

  <Step title="Check it's working">
    Back on the **Integration** page, your key shows **last report** with a time once the plugin has sent its first visits. Until then it says *never used yet*.

    AI crawlers visit on their own schedule, so the first report can take anything from minutes to a few hours on a quiet site.
  </Step>
</Steps>

## What to report

**Settings → Agent Analytics → What to report** lets you choose how much the plugin sends:

| Setting                                                             | What's sent                                                                                                                     |
| ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **AI crawlers only**                                                | Crawler visits. Nothing at all about people's visits.                                                                           |
| **AI crawlers and arrivals from assistants** (default, recommended) | Also each person who arrives from an assistant — the time, the assistant and the page, nothing more.                            |
| **Every request, including ordinary visitors**                      | Every page view as well. This is personal data under GDPR, so turn it on only if your privacy policy and lawful basis cover it. |

## One key per site

Create a separate key for each site that reports to the project. You'll see each one's last report on its own, and you can switch one site off without touching the others.

## Revoking a key

**Revoke** a key on the Integration page to stop that site reporting immediately. Visits it already sent stay in your project. To reconnect the site, create a new key and paste it into the plugin.

## If the plugin shows an error

| Message                               | What to do                                                                                                                                                |
| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Unknown or revoked ingest key         | The key was mistyped or revoked. Create a new one and paste it in again.                                                                                  |
| Collection is paused — no active plan | The organization's plan isn't active. Nothing is stored until it is. See [Trial and billing](/account/trial-and-billing).                                 |
| Monthly allowance used up             | Your plan's visits for this month are used. Collection resumes on the 1st, or sooner on a larger plan. See [Plans and limits](/account/plans-and-limits). |

Not on WordPress? Any server, CDN or edge worker can report visits over HTTP — see [Any other site](/agent-analytics/http-api).