WordPress Setup

WordPress crawler tracking uses a lightweight plugin that detects AI bot visits server-side. It's more reliable than client-side tracking because AI crawlers don't execute JavaScript.

Before you start

You'll need:

• A WordPress site (self-hosted WordPress.org, not WordPress.com free tier)
• Admin access to install plugins
• Your WordPress site already connected in Settings > Site Integration

Step 1: Connect your WordPress site

If your site isn't connected yet:

1. 1Go to Settings > Site Integration
2. 2Click Connect WordPress
3. 3Enter your site URL and authorize via OAuth
4. 4Confirm the connection is active

Once connected, your site will appear in the crawler tracking setup.

Step 2: Enable crawler tracking

1. 1Navigate to the Crawler Tracking page
2. 2Click Connect on the WordPress card
3. 3Select your connected WordPress site from the list
4. 4Click Enable Tracking

Trakkr checks whether the crawler plugin is already installed on your site.

Step 3: Install the plugin (if needed)

If the plugin isn't detected, you'll see an "Almost there" message. Install it manually:

1. 1Log in to your WordPress admin dashboard
2. 2Go to Plugins > Add New
3. 3Search for "Trakkr Crawler"
4. 4Click Install Now, then Activate

Once activated, tracking starts automatically - no configuration needed. The plugin detects AI crawler user agents (GPTBot, ClaudeBot, PerplexityBot, etc.) and reports visits to Trakkr in real time.

What the plugin does

The Trakkr Crawler plugin is lightweight and focused:

• Detects AI bot user agents on every request
• Reports visits to Trakkr (crawler name, page URL, timestamp)
• Ignores human visitors entirely - no tracking of real users
• Runs server-side so it catches crawlers that skip JavaScript

The plugin adds no front-end scripts, doesn't slow your site, and stores nothing in your WordPress database.

Troubleshooting

"No WordPress sites connected"

You need to connect your site first. Go to Settings > Site Integration > Connect WordPress, then come back to Crawler Tracking.

Plugin not detected after installation

• Make sure the plugin is activated (not just installed)
• Check that it's the official "Trakkr Crawler" plugin
• Try refreshing the Crawler Tracking page in Trakkr

No crawler data after setup

• AI crawlers visit periodically, not constantly. Give it 24-48 hours
• Check that your site isn't behind a cache that strips headers
• Verify the plugin is active in WordPress > Plugins

Plugin conflicts

If you're seeing errors after activation:

• Deactivate other security plugins temporarily to identify conflicts
• Check that your PHP version is 7.4 or higher
• Look in WordPress > Tools > Site Health for issues

Removing the integration

To stop tracking:

1. 1Deactivate the Trakkr Crawler plugin in WordPress
2. 2Remove the connection in Trakkr (Crawler Tracking page)

Your WordPress site connection in Settings remains intact - only crawler tracking is removed.

Next steps