Websites
Set up Contentful
Connect a Contentful space to make every published entry searchable — the marketing site, help centre and product copy behind your site, with text and rich-text fields flattened to prose and each entry tied to its content type, so the CMS answers questions directly. Read-only.
Before you start
- The Space ID: in the Contentful web app open Settings → General settings — it's the short code shown there, and also in the URL after /spaces/.
- A Content Delivery API access token: under Settings → API keys open (or add) an API key and copy its Content Delivery API access token.
- The Content Delivery API reads published content only — exactly what syncs — and only reads are ever issued; it can't write to your space.
- Documents → Contentful, enter the Space ID and paste the token as Content Delivery API token.
- Optional, under Advanced: name an Environment if your team really publishes from one other than master — blank uses master, the environment your site serves.
- Choose access groups, Test, then Sync.
What comes in
- Every published entry of every content type becomes one document headed with its content type and last-updated date; its title comes from a title, name or headline field, or from the first line of its first text field when it has none.
- Text and rich-text fields are flattened to plain prose in order — paragraphs, headings and list items each on their own line; a list field joins whatever text its elements carry.
- A field that links to an asset (an image, a PDF) carries no text of its own and isn't fetched — Sync counts those references in its notes; a link to another entry carries nothing either. An entry with no text-bearing fields is left out.
- Editing an entry in Contentful brings the new version in on the next sync.
| Environment | Blank = master, the environment your site actually serves. Contentful environments hold parallel versions of a space's content; name a different one only if your team really publishes from one. |
|---|
Access
Access is allow-only: every entry this source brings in is visible to the groups you choose when setting it up — the Content Delivery API carries no per-entry reader list to mirror.
Entries are capped at 3,000, read 100 at a time — Sync notes it and keeps the most recently created ones if a space has more, and entries already synced beyond the cap stay searchable. Test reports the space's total published entry count without syncing anything; on failure it says why — a rejected token reports that Contentful rejected the credentials, a wrong Space ID or environment comes back with Contentful's own error. To cut access, delete the API key where it was created, under Settings → API keys.
Last updated 20 Sep 2026