Documentation
Publish to Framer CMS
Connect a Framer project and publish articles into a CMS collection with automatic field mapping and slug-safe updates.
Publish to Framer CMS
Connect PrismSEO to your Framer project and publish generated articles directly into a CMS collection — as a draft or a live item. PrismSEO maps each article to your collection fields and updates the existing item on a slug match, so re-publishing never creates duplicates.
Best for startups and design-led teams that build their site in Framer and want SEO content shipping without leaving it.
Prerequisites
- A Framer project on a plan that includes the CMS and API access.
- A CMS collection for blog posts, with routes like
/blogsand/blogs/:slug. - A Personal Access Token (API token) that can read and write CMS items.
- Collection fields that can receive an article — at minimum a title, slug, and rich-text/HTML body.
Step 1 — Prepare your Framer collection
PrismSEO matches your collection fields by name, so name them clearly. Recommended fields:
- Title — plain text (the collection's title field).
- Slug — the collection's slug field.
- Content — a rich text / HTML field for the article body.
- Excerpt — plain text (optional).
- SEO Title and SEO Description — plain text (optional).
- Cover Image — image field (optional).
If your body field is a Framer "Rich Text" field, PrismSEO sends HTML-first content that Framer renders as formatted text. Keep one dedicated body field per collection.
Step 2 — Collect your Framer values
From Framer, gather:
- API Token — your Personal Access Token (create it in Framer account settings).
- Project ID — your project's ID or URL.
- Collection ID — the target CMS collection's ID.
- Site URL *(optional)* — your published domain, used only so Publish History can show a clean final URL like
https://yoursite.com/blogs/your-slug.
Step 3 — Connect Framer in PrismSEO
- Open Dashboard → Integrations → Framer CMS.
- Enter the API token, project ID, collection ID, and optional site URL.
- Click Connect Framer CMS.
PrismSEO validates the token, project, and collection before saving, and inspects the collection's fields so it knows where to place each part of the article.
Step 4 — Publish an article
- Open or generate an article in Content.
- Click Publish → Framer.
- Choose a mode:
- Draft — creates an unpublished CMS item.
- Publish — creates a live CMS item.
- Confirm. PrismSEO writes the item into your collection and records the result in Publish History.
If an item with the same slug already exists, PrismSEO updates that item instead of creating a new one.
Field mapping
PrismSEO sends these values and matches them to your collection fields automatically:
title→ your Title fieldslug→ your Slug fieldcontentHtml→ your Content (rich text / HTML) fieldexcerpt→ your Excerpt fieldseoTitle→ your SEO Title fieldseoDescription→ your SEO Description fieldcoverImage→ your Cover Image fieldstatus→ draft or published, from the mode you selected
Fields it can't find a match for are simply skipped — the publish still succeeds with the fields that do match.
Troubleshooting
Every attempt shows in Publish History with its status. Common issues:
- Invalid token / project / collection — double-check all three values; a token from a different Framer account or project will fail validation.
- Slug collision constraints — if your collection enforces unique slugs, PrismSEO updates the existing item; make sure your slug field is the real slug field.
- Field not populated — the field name in your collection doesn't match a recognized name. Rename it (e.g. "Content", "Excerpt", "SEO Title") so PrismSEO can map it.
- Timeout / upstream Framer error — retry, then reconnect the credentials if it persists.
For deeper fixes, see Framer Publishing Troubleshooting.
Next step
Apply this setup, then run your first publish cycle from your dashboard.