# Overview

> Push articles directly into your existing CMS (WordPress, Webflow, Ghost, Shopify, Notion, etc.) instead of rendering them from Mentionwell's API.

# 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](/docs/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)](/docs/publish/wordpress)** — REST API + Application Passwords. The most stable.
- **[Webflow](/docs/publish/webflow)** — Webflow Data API v2, into a Blog Posts CMS Collection.
- **[Ghost](/docs/publish/ghost)** — Admin API + Lexical-aware HTML conversion.
- **[Shopify](/docs/publish/shopify)** — Admin API `/blogs/{id}/articles` for Shopify's built-in blog.
- **[Notion](/docs/publish/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

1. You give Mentionwell credentials for the target CMS (one access token + the IDs Mentionwell needs to find your blog/collection/database).
2. 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.
3. 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](/docs/webhooks) 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.


---

Canonical URL: https://mentionwell.com/docs/publish
Live HTML version: https://mentionwell.com/docs/publish
Section: Publish to your CMS
Site index for AI ingestion: https://mentionwell.com/llms.txt
Full reference: https://mentionwell.com/llms-full.txt