Connecting WordPress Websites

Overview

The CrawlSage WordPress Plugin is the recommended integration method for WordPress sites. Once installed and connected, CrawlSage can automatically deploy AI-generated meta tags, schema markup, and canonical URLs directly into your WordPress database — no manual FTP uploads or template edits required.

Prerequisites

• WordPress version 5.6 or higher.
• Administrator access to your WordPress dashboard.
• A CrawlSage project configured for your WordPress domain.
• The REST API must be enabled (it is enabled by default in WordPress 5.6+).

Plugin Compatibility

Step 1: Install the Plugin

1. Log in to your CrawlSage dashboard and navigate to your project's Settings → Integrations tab.
2. Click "Download WordPress Plugin" to download the crawlsage.zip file.
3. Log in to your WordPress admin panel at yoursite.com/wp-admin.
4. Go to Plugins → Add New → Upload Plugin.
5. Select the downloaded crawlsage.zip file and click "Install Now".
6. After installation, click "Activate Plugin".

Step 2: Configure API Connection

1. In your WordPress admin sidebar, find and click the CrawlSage menu item.
2. In your CrawlSage dashboard, navigate to Project Settings → API Keys and copy the project connection token.
3. Paste the token into the Connection Token field in the WordPress plugin settings.
4. Click "Save Connection".

Step 3: Verify Connection

1. After saving, click "Test Connection" in the plugin settings page.
2. A green "Telemetry Active" badge will appear if the connection succeeds.
3. Return to your CrawlSage dashboard — your project's integration status will now show "WordPress Connected".

Common Mistakes

• Conflicting SEO plugins: If you have Yoast SEO or Rank Math active, they may override CrawlSage-deployed meta tags. Disable their meta tag output for pages managed by CrawlSage, or configure CrawlSage to write to a custom field instead.
• REST API disabled: Some security plugins (e.g., WP-Config Disabler) disable the WordPress REST API. If the connection test fails, check that yoursite.com/wp-json is accessible.
• Wrong token pasted: Each project has a unique token. If you manage multiple sites, ensure you paste the correct project's token in the correct WordPress installation.

Troubleshooting

• Connection test fails with "Unauthorized":
  1. Verify the token was copied completely without leading or trailing spaces.
  2. Regenerate the token in your CrawlSage project settings and re-paste it.
• Plugin shows "REST API Blocked":
  1. Check if a security plugin is filtering REST API requests.
  2. Temporarily disable security plugins and re-test. Then whitelist the CrawlSage user-agent in your security plugin settings.