Publish to your CMS
Most users render Mentionwell posts via the public reader API — your site fetches them on every request. That's the simplest setup, covered in Quickstart.
But sometimes you want articles to land inside your existing CMS so they appear next to content authored by humans, picked up by your existing theme, and edited later by your team. That's push mode.
Two delivery models, one Mentionwell
| Model | When to use it |
|---|---|
| Pull (default) | Static sites, frameworks (Next.js, Astro, etc.), anything you control the rendering of. Zero CMS needed. |
| Push (this section) | You already use a CMS (WordPress, Webflow, Ghost, Shopify, Notion) and want Mentionwell's articles to land in it. |
You can mix both — pull on a Next.js marketing site while pushing to WordPress for an internal blog, for example.
Supported destinations
- WordPress (self-hosted) — REST API + Application Passwords. The most stable.
- Webflow — Webflow Data API v2, into a Blog Posts CMS Collection.
- Ghost — Admin API + Lexical-aware HTML conversion.
- Shopify — Admin API
/blogs/{id}/articlesfor Shopify's built-in blog. - Notion — official API into a database; renders via Super.so / Potion / Feather.
Coming soon: HubSpot, Wix, WordPress.com (OAuth), Framer.
Not supported (and why)
- Squarespace — no public publishing API. Workaround: push to a WordPress staging site, use Squarespace's WordPress import. We don't bake this into the product because the round-trip is fragile.
How push mode works
- You give Mentionwell credentials for the target CMS (one access token + the IDs Mentionwell needs to find your blog/collection/database).
- When an article publishes in Mentionwell, the worker calls the destination's API: creates the post, attaches the featured image, sets tags + categories, and (where supported) injects JSON-LD for SEO.
- We log success/failure on the article in the dashboard. Failed pushes can be retried.
The same article still appears in Mentionwell's own reader API, so you can keep the pull-based path running too.
Webhook fallback
If your destination doesn't have a supported integration, point a webhook at it. Mentionwell signs every payload with HMAC-SHA256 so you can trust it came from us, then your endpoint does whatever it wants with the article.