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

# WordPress

> Integrate Siteline with WordPress

Install the [Siteline Agent Analytics](https://wordpress.org/plugins/siteline-agent-analytics/) plugin to track AI bot visits on your WordPress site. No code required — the plugin runs in fire-and-forget mode inside WordPress hooks, so there is zero impact on page load times.

## Prerequisites

* A [Siteline website key](/authorization)
* Administrator access to your WordPress site
* Ability to install plugins on your WordPress installation

## Setup

<Steps>
  <Step title="Open the Plugins panel">
    Navigate to your WordPress admin panel at `https://yoursite.com/wp-admin` and click **Plugins** in the left sidebar.
  </Step>

  <Step title="Search and install">
    Search for [Siteline Agent Analytics](https://wordpress.org/plugins/siteline-agent-analytics/) in the Plugins search bar, then click **Install Now**.
  </Step>

  <Step title="Activate">
    Back in the Plugins list, click **Activate** under the Siteline Agent Analytics plugin.
  </Step>

  <Step title="Configure">
    Go to **Settings** > **Siteline** in the left sidebar and configure:

    * **Enable Tracking**: Leave checked (uncheck to pause tracking)
    * **Website ID**: Paste your Siteline website key from [siteline.ai](https://siteline.ai)

    Click **Save Changes** to apply.
  </Step>

  <Step title="Enable auto-updates (recommended)">
    On the Plugins page, enable auto-updates for Siteline to stay up to date automatically.
  </Step>
</Steps>

## How it works

The plugin hooks into WordPress request processing:

1. A visitor (or AI bot) makes a request to your WordPress site
2. The plugin detects the request and extracts bot-relevant metadata (URL, user agent, IP, referrer)
3. Tracking data is sent to Siteline asynchronously in a fire-and-forget pattern
4. The page response is returned to the visitor unmodified

Errors are silently caught and discarded — the plugin never interferes with your site's normal operation.

## Plugin settings

<ResponseField name="Enable Tracking" type="boolean" required>
  Toggle AI bot tracking on or off. Checked by default.
</ResponseField>

<ResponseField name="Website ID" type="string" required>
  Your Siteline website key. Found under **Agent Analytics** > **Manage Configuration** in your Siteline workspace.
</ResponseField>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Plugin not tracking visits">
    Verify that **Enable Tracking** is checked in **Settings** > **Siteline** and that your Website ID is entered correctly.
  </Accordion>

  <Accordion title="Where do I find my Website ID?">
    Navigate to **Agent Analytics** in your Siteline workspace and click **Manage Configuration** to view or regenerate your website key, then paste it into the plugin's **Website ID** field.
  </Accordion>

  <Accordion title="How do I update the plugin?">
    If auto-updates are enabled, the plugin updates automatically. Otherwise, go to **Plugins**, find Siteline, and click **Update Now** when available.
  </Accordion>

  <Accordion title="Will the plugin slow down my site?">
    No. The plugin sends tracking data asynchronously and never blocks page rendering. All errors are silently caught.
  </Accordion>
</AccordionGroup>

<Tip>
  **Need help?** [Book a setup call](https://cal.com/team/siteline/tech-set-up) and we'll walk you through it.
</Tip>