Paste your bucket keys — articles arrive as objects in your own Cosmic bucket.
Cosmic is an API-first headless CMS. You paste your bucket slug with its read and write keys, DraftSEO reads your object types, and you confirm which metafields hold the body, the featured image, the excerpt and the SEO fields. Each article is then written as an object of your own type, with every image uploaded to your Cosmic media library first. Cosmic is headless, so your own website displays the article; you tell DraftSEO the address pattern your posts live at.
| Connection | Bucket slug + read and write keys — Bucket → Settings → API Access |
|---|---|
| Body metafield | Rich text · Markdown · HTML — matched to your body metafield |
| Image hosting | Your Cosmic media library — uploaded, never hot-linked |
| Your own metafields | Left untouched on republish — only the mapped metafields are written |
| Publish modes | Auto · draft · scheduled |
Who does what
Nothing — once the keys are pasted and the metafields are mapped, objects appear in your bucket and your website shows them. Want to review first? Send them as drafts and publish from the Cosmic dashboard.
Works with whatever your object type and its metafields are called.
Setup
In Cosmic open your bucket → Settings → API Access and copy the bucket slug, the read key and the write key.
~1 minute
Connect a site → Cosmic → paste the slug and both keys. DraftSEO lists the object types an article can go into.
~1 minute
Confirm which metafield holds the article body, and optionally the featured image, excerpt and SEO fields. DraftSEO suggests the mapping from your own content model.
~2 minutes
Tell DraftSEO where posts appear on your website, e.g. https://www.yoursite.com/blog/{slug}.
~30 seconds
FAQ
Rich text, Markdown and HTML. Rich text and Markdown metafields receive the article as Markdown with headings, lists, links, tables and images; an HTML metafield receives it as HTML. Videos become links in Markdown bodies.
Your choice. Published articles go live in your bucket straight away. Drafts are saved with Draft status, so you can review them and publish from the Cosmic dashboard.
No. DraftSEO updates the same object and only writes the metafields you mapped. Authors, categories and anything else your editors fill in stay as they are, and the slug never changes.
In your own Cosmic media library, served from Cosmic’s image CDN. Each image is uploaded before the object is written, so the article never loads images from our servers.
No card required. Images hosted in your own Cosmic media library.