Publishing and CMS

Contentful integration

Contentful is a content model before it is a website. The Contentful integration creates and updates entries against that model, so published work fits the structure your developers designed.

What it is

What the Contentful integration is

The Contentful connection writes entries into a space and environment you choose, against the content type you nominate. Fields are mapped explicitly, so a draft becomes a valid entry rather than something that fails validation on save.

Entries can be created as drafts and left for an editor to publish, which matches how most teams using Contentful already work: content is reviewed in the web app, then published to whichever front end consumes the API.

Spaces and environments
Content types and entries
Field mappings
Draft and published state
What it does

What you can do with it

Four questions the two data sets answer together that neither answers alone.

Entries are created against the content type you nominate, with fields mapped explicitly, so nothing arrives in a shape your front end cannot render.

How it works

How the Contentful integration works

About a minute to connect, and nothing to maintain afterwards.

1

Create a Contentful management token

In Contentful, create a Content Management API token with access to the space you want to publish into.

2

Connect it in WriteWorks

Open Settings, then Integrations, and choose Contentful. Add the token and pick the space and environment.

3

Map to a content type

Choose the content type new work should use, and map the draft's title, body, slug and summary to its fields.

4

Publish and track

Approved drafts become entries. Once the entry is live, the URL is tracked for citations and search performance.

Who it is for

Who uses the Contentful integration

The same connection answers a different question depending on who is asking.

Content that arrives valid against the model, without a bespoke import script to maintain.

You bring your own account. The Contentful integration authenticates with your own account at Contentful, on your own plan and your own quota. WriteWorks reads the data that account already has access to, and nothing else. Disconnect at any time and the stored credential is deleted.

Related

Works well alongside

FAQ

Contentful integration FAQs

The questions teams ask before connecting it.

What does the Contentful integration do?+
It creates and updates entries in your Contentful space from finished WriteWorks drafts, against a content type and field mapping you choose.
Which token does it need?+
A Content Management API token, because creating and updating entries is a write operation. Delivery tokens are read-only and cannot publish.
Can I publish to a staging environment first?+
Yes. You pick the space and environment, so content can be staged before it reaches production.
How do I connect Contentful to WriteWorks?+
Create a management token in Contentful, then open Settings, Integrations, choose Contentful, add the token, pick the space, environment and content type, and map the fields.
Does it publish entries automatically?+
Only if you configure it that way. Entries can be created as drafts for your editors to publish.
What happens if I disconnect it?+
The stored token is deleted and WriteWorks stops writing to the space. Entries already created are untouched.

Connect Contentful and see the whole picture

Measure how 10+ AI platforms answer your buyers, join it to the paid and organic data you already have, and ship the content that flips the citation.

Contentful Integration | WriteWorks