Integration

WordPress integration

Last updated July 23, 2026

Install the Mentionwell companion plugin, copy the per-site secret from Connect, and choose whether managed articles arrive as drafts, pending posts, private posts, or live posts. Every publish, update, test, and delete is HMAC-signed.

How it works

Download and install. Download the plugin ZIP, then use WordPress → Plugins → Add New → Upload Plugin.
Configure. In Settings → Mentionwell, paste the webhook secret and Site ID from Connect. Add a PAT only if you enable AI-bot crawl reporting.
Connect delivery. In Mentionwell, choose the WordPress CMS adapter and paste https://yoursite.com/wp-json/mentionwell/v1/webhook.
Pick a publish strategy. The plugin supports draft, pending review, private, or live posts. Start with drafts for the first client articles.
Verify. Run Test connection. The plugin authenticates the signed post.test event without creating a post.
Optional bulk import. Pull your existing archive in for AEO measurement and the bulk-optimize pass.

Why this beats writing in WordPress directly

You measure first. The AEO scan tells you which prompts you’re losing on before you write anything.
Editorial pass on every draft. The reflection critic auto-rewrites anything below 0.8 confidence. The Gutenberg editor doesn’t.
Schema by default. The plugin stores Mentionwell JSON-LD and emits it when Yoast or Rank Math is not already managing schema.
4K images out of the box. Featured + inline images that respect your brand’s visual identity.
Cost ledger. See per-article token spend so the CFO’s question is answered before they ask.

What gets written into WordPress

Standard WordPress post title, slug, HTML body, excerpt, and configured status.
Categories and tags, including the optional category mapping from plugin settings.
Featured image sideloaded into the media library.
Meta title, meta description, canonical URL, language, and JSON-LD as managed post metadata.
Automatic right-to-left wrapper for Hebrew and Arabic managed posts.

Pricing

The WordPress integration is included on every paid plan — Builder, Starter, Growth, Scale, Enterprise. Free does not push to external destinations. See pricing for the full plan matrix.

Questions

Do I need to install a plugin?

Yes for native wp-admin publishing. Install the Mentionwell companion plugin, paste the per-site webhook secret, and point Mentionwell at the endpoint the plugin displays. The public Reader API remains available as a separate pull-mode option.

Will my existing WordPress posts still work?

Yes. Mentionwell only writes new posts (and edits ones it created). It never touches posts authored outside the integration unless you explicitly run the bulk-optimize pass.

Can I import my existing WordPress archive?

Yes. Either upload your WXR export or point us at the REST API — slugs are preserved, categories and tags map across, and existing rankings stay intact. The bulk-optimize pass then refreshes metadata and injects FAQs for AEO.

What about featured images?

The plugin sideloads the featured-image URL into the WordPress media library and sets it on the managed post.

Does it work with multisite, headless WP, or custom post types?

The current plugin writes standard posts on self-hosted WordPress. Headless teams can read the same posts through WordPress or use Mentionwell’s Reader API. Multisite and custom post-type automation require a scoped onboarding review.

How are retries and deletes handled?

Publishes update by slug, so retries do not duplicate posts. Mentionwell also sends signed delete events to the same plugin endpoint; the plugin only removes posts it previously marked as Mentionwell-managed.