Skip to main content
The ChatFeatured WordPress plugin connects a WordPress site to your project. Once it’s connected you can publish articles as WordPress posts, see AI crawler traffic in Agent Analytics, and turn on Index Submissions so we submit your site to AI search engines directly. You manage it under Integrations → WordPress.
Install the plugin on your live site, not a staging copy. AI crawlers visit your live domain, so Agent Analytics only sees traffic there.

​
Requirements

  • WordPress 6.0 or later and PHP 7.4 or later
  • An administrator account on the site
  • Plugin 2.3.0 (the current version) for the editable slug and the SEO plugin fields. When a site runs an older one, its row in ChatFeatured says so.

​
Connect a site

1

Download the plugin

In ChatFeatured, open Integrations → WordPress, expand Download the Plugin under Setup Instructions, and click Download Plugin.
2

Install and activate it

In WordPress admin, go to Plugins → Add New → Upload Plugin, choose the zip, click Install Now, then Activate. We recommend turning on auto-updates for it.
3

Copy the site URL and token

Open ChatFeatured in the WordPress admin menu. The ChatFeatured Setup screen shows the API token (it starts with cf_) and your site URL, each with a Copy button.
4

Click Complete Setup

Click Complete Setup on that screen. It turns on analytics, publishing and index submissions on the WordPress side. Without it, Agent Analytics shows “Disabled in WordPress”.
5

Connect in ChatFeatured

Back on Integrations → WordPress, fill in WordPress Site URL and API Token, optionally a Display Name, and click Connect WordPress.
The site appears under Connected Sites with publishing and Agent Analytics switched on. Expand its row to switch either off or update the token. You can find the token again later under ChatFeatured → Settings → API Key in WordPress. Click Add Site to connect more sites; each has its own token. On a multisite network, copy the URL and token from the same subsite.

​
Publish an article

Open the article and click the publish button (Publish to and the site name if you have several). The Publish to WordPress dialog has:
  • Slug: click it to edit.
  • Publish Status: Save as Draft, Publish Immediately or Schedule for Later.
  • Categories: picked from the site’s existing categories.
  • Tags: comma-separated. New tags are created.
  • Author: pick one if your theme shows bylines. Default author leaves it unset.
  • Featured Image: upload one to replace the article’s own.
The plugin creates posts only, not pages or custom post types. On sites running Yoast SEO or Rank Math, the meta description and focus keyphrase go into the SEO plugin’s fields, and the site’s row in ChatFeatured has a Use ChatFeatured article schema switch: on, the article’s JSON-LD schema replaces the SEO plugin’s Article schema. Deleting the article in ChatFeatured doesn’t delete the post. Once published, the publish button becomes Manage In WordPress. To change the post, choose Unpublish from the article’s menu in the Articles list, edit it, then publish again. The same post is updated.

​
Agent Analytics and Index Submissions

Agent Analytics needs the site’s Agent Analytics switch on in ChatFeatured and Enable Analytics on in the plugin (Complete Setup turns it on). Index Submissions has its own card on the WordPress integration page. New articles are submitted when they go live, and posts you write or edit in WordPress are picked up from your sitemap each week. With several sites connected, it covers one, and the card names which.

​
Troubleshooting

The latest error also shows as “Last error” on the site’s row.
The token was regenerated or copied wrong. Copy it again from ChatFeatured → Settings → API Key in WordPress and paste it into Update API Token in the site’s row.
Check that the plugin is active and that the URL is the site (or subsite) it’s installed on.
Your web server removes the header that carries the token, so every token fails until the server is fixed. A security plugin can also strip it, so rule that out first. On Apache, your host can add this above the # BEGIN WordPress block in .htaccess:
Some managed hosts strip the header themselves and need a support ticket.
You can’t turn this off from your SiteGround account. Ask SiteGround support to whitelist the ChatFeatured outbound IPs for your hosting account, including write (POST) requests.