Products SEO & GEO Agent Paid Ads Agent Website Agent Conversion Agent
How it works Pricing FAQ Blog Book a call

Contentful SEO: headless CMS setup and fast LCP

Updated · 10 min read

Short answer Contentful only stores your content; the site your developer built on top of it decides your SEO. Check that every page has its own SEO title, description and slug, that pages reach Google as finished HTML, and that the top photo is resized, served as WebP or AVIF, and never lazy-loaded.

Want help applying this to your business? Talk it through on a free 30-minute call.

Book a call

Contentful SEO checklist: what to check and who does it

Contentful is a headless CMS: it holds your words and photos, and a separate front end, written by a developer, turns them into the pages people and Google see. So most SEO on a Contentful site is code, not a settings tab. Go through this table with whoever built the site.

#CheckWhere it livesHow to tell it's done
1SEO title and meta description on every page typeFields in the content model, printed by the site codeView the page source: your title and description are near the top
2A slug field that must be uniqueContent modelTwo entries can't publish with the same slug
3Pages reach Google as finished HTMLSite code (pre-built or server-rendered)Your headline and service text appear in the page source
4A "hide from search" switchField in the content model, printed as a noindex tagTurning it on adds a robots noindex line to that page's source
5Canonical tag pointing to the page's own addressSite codeThe source shows a canonical link with the page's own URL
6Sitemap and robots.txtSite code or hostyourdomain.com/sitemap.xml and /robots.txt open
7A 301 redirect when a slug changes or a page is deletedSite code or hostThe old address lands on the new page
8Business details as structured dataSite code, filled from Contentful fieldsGoogle's Rich Results Test finds it
9Resized, modern-format imagesImages API settings in the site codeImage addresses include w= and fm=webp or fm=avif
10Site updates when you publishA Contentful webhook to the hostA published change shows up on the live site
11Google Search Console connectedYour Google accountThe Pages report lists your pages

Rows 1, 2 and 4 are fields a developer adds once; you fill them in per page. The rest is code. Sitemaps, robots.txt and redirects live on your own domain, so they come from the site's code or host, not the Contentful editor.

Is Contentful good for SEO?

It's neutral. Contentful doesn't make the pages Google reads, so on its own it can't help or hurt your rankings. Its documentation puts the job on the front end:

"To ensure that search engines can consume the SEO metadata, the frontend application needs to render the values in the corresponding HTML meta-tags." (Contentful Docs: Compose content model and SEO)

On hosted builders like Wix or Squarespace, SEO settings come built in. On Contentful, SEO fields exist only if someone adds them. Even pages made in Contentful's visual page builder, Studio, typically come with just a title and slug; its guide shows developers adding SEO title and description fields themselves (Contentful Docs: Experience reference fields for metadata).

The trade: one set of content can feed a website, an app and more, but every SEO feature a builder includes has to be built and kept working.

SEO fields to add to the Contentful content model

Ask your developer for these fields on every content type that becomes a page:

FieldContentful field typeSettingBecomes on the page
SEO titleShort textRequired, uniqueThe title tag, the blue link in Google
Meta descriptionShort textRequiredThe snippet that often shows under the link
SlugShort textRequired, uniqueThe end of the page address, like /drain-cleaning
Hide from searchBooleanOff by defaultA robots noindex tag when on
Canonical URLShort textOptional, blank by defaultA canonical tag; blank means the page's own address
Share imageMediaOptionalThe picture shown when the page is shared

Contentful's "unique" setting blocks publishing when another entry already has the same value: it "Validates that there are no other entries that have the same field value at the time of publication" (Contentful Docs: Content types). Use it on titles and slugs, so no two pages share a title or collide on one address. Google's JavaScript SEO guide says unique, descriptive titles and meta descriptions help searchers pick the right result.

Skip a keywords field. Contentful's older Compose SEO model includes one, but Google says:

"The meta-keyword tag is not used by Google Search, and it has no effect on indexing and ranking at all." (Google Search Central: Meta tags and attributes that Google supports)

The fields can sit on each page type, or in one "SEO" content type linked from every page, as Compose did. The second keeps them in one place.

Will Google index a Contentful site?

Yes, if pages reach Google as readable HTML. A 30-second test: open a service page, right-click, choose View Page Source, and search for a sentence on the page. Found it? The page is pre-built or server-rendered. Mostly scripts around an empty container? The page is assembled in the visitor's browser, called client-side rendering.

Google can run that JavaScript, after a wait in a rendering queue. Its advice:

"Keep in mind that server-side or pre-rendering is still a great idea because it makes your website faster for users and crawlers, and not all bots can run JavaScript." (Google Search Central: JavaScript SEO basics)

AI assistants are among those bots. In a December 2024 study of traffic on Vercel's hosting network, Vercel and MERJ found that none of the major AI crawlers rendered JavaScript, including those from OpenAI, Anthropic and Perplexity; Google's Gemini used Googlebot's setup and could. So a page built only in the browser may be blank to ChatGPT and Claude.

How pages are builtWhat Google gets firstAI crawlers (2024 study)Effect on load speed
Pre-built at publish (static)Finished HTMLCould read itUsually fastest
Server-rendered on each visitFinished HTMLCould read itFast; server time adds a little
Built in the browser (client-side)A near-empty shell, rendered laterDidn't read itSlow: the main image waits for scripts
Dynamic rendering (bots get HTML, people get scripts)Finished HTMLDepends on setupSlow for people, as above

On the last row, Google says "Dynamic rendering was a workaround and not a long-term solution," and recommends server-side rendering, static rendering or hydration instead (Google Search Central: Dynamic rendering as a workaround).

A pre-built site also needs a Contentful webhook, a message to the host when someone publishes, to "trigger a website rebuild" (Contentful Docs: Webhooks overview). Without it, a fixed title can sit in Contentful and never go live.

Two more checks from Google's JavaScript guide:

  • Menus use real links with an address, not click handlers or # fragments. Google says it can only discover links that are proper HTML links with an href.
  • Look at what Google rendered. In Search Console, URL Inspection shows the rendered HTML. Google: "If the content isn't visible in the rendered HTML, Google won't be able to index it."

Pages found but left out of Google: crawled or discovered, currently not indexed.

How to fix LCP on a Contentful site

LCP (Largest Contentful Paint) is when the biggest thing on the first screen, usually the top photo or headline, finishes showing. Google's PageSpeed Insights counts 2.5 seconds or less as good, up to 4 seconds as needs improvement, and over 4 seconds as poor. How much it moves rankings: Core Web Vitals and Google ranking.

On Contentful sites the usual culprit is the top photo. Check these in order:

CauseFix
The photo is served as uploadedAdd Images API settings to its address: w (width, up to 4,000 px), fm=webp or fm=avif (format), q (quality, 1 to 100). Example ending: ?w=1600&fm=webp&q=75
Phones get the desktop-size fileRequest smaller widths for small screens
The top photo is lazy-loadedRemove loading="lazy" from that one image
The browser doesn't know it mattersSet fetchpriority="high" on that image; web.dev says doing it on more than one or two images makes it unhelpful
Images load from a second domainContentful serves them from images.ctfassets.net, which costs an extra connection. Preconnect to it; web.dev says serving images from your own domain is best
The page is built in the browserPre-build or server-render it, so the photo is in the HTML from the start
The server is slow to send the pagePre-build pages, or cache server-rendered pages on a CDN (content delivery network)

Two facts settle the most common mistakes. Contentful's default format "is the original image format" (Contentful Docs: Images API), so a 5 MB phone JPEG stays 5 MB unless the code asks for less. And from Google's web.dev team:

"Never lazy-load your LCP image, as that will always lead to unnecessary resource load delay, and will have a negative impact on LCP." (web.dev: Optimize Largest Contentful Paint)

web.dev also warns that some tools add lazy loading to images automatically, so check the first one.

Two Contentful limits: AVIF conversion works only from source images up to 9 megapixels, and uploads over 100 MB aren't transformed at all (Contentful Docs: Technical limits). A 12-megapixel phone photo (4,000 × 3,000) is over the AVIF limit, so resize it before upload or use WebP.

Skip AMP. Google "applies the same standard to all pages, regardless of the technology used to build the page" (Google Search Central: About AMP on Google Search).

What Contentful costs, and whether you need it

Contentful's pricing page lists three plans (as archived July 2026; the live page blocked automated reading):

PlanPriceMain limits
Free$010 users, 2 locales (language versions), 100,000 API calls and 50 GB of image and file bandwidth a month, no overages; 25 content types and 10,000 records
Lite$300 a month20 users, 3 locales, 1 million API calls and 100 GB a month
EnterpriseCustomStudio, the visual page builder, and personalization are offered here

Hosting and the developer are separate costs. A pre-built site calls Contentful's API when it rebuilds, not on every visit, while photos served from Contentful count toward bandwidth.

For a 10-page service business site, headless is usually more machine than you need: a hosted builder ships the settings in the checklist above without code. Headless pays off when one set of content feeds several sites, apps or languages. If an agency built yours, make sure your business owns the Contentful organization, the code and the hosting account: leaving your agency without losing your site.

Example

Illustrative cases; the numbers are invented.

A dental group with a slow homepage (US dollars)

The hero photo is a 6 MB JPEG, lazy-loaded by the template, and mobile LCP is 5 seconds. The developer adds ?w=1600&fm=webp&q=75, removes lazy loading and marks it high priority. The file drops to about 300 KB. Cost: two developer hours, about $300.

A law firm whose pages are blank in the source

The agency built a browser-only app. View Page Source shows an empty container, Search Console lists most pages as not indexed, and ChatGPT can't describe the practice areas. The firm switches to pre-built pages with a rebuild webhook and keeps its Contentful content.

A landscaper who renamed a slug

The owner changed "services-1" to "lawn-care" in Contentful. The old address now shows a 404, and a $400-a-month ad still points there. The developer adds a 301 redirect at the host, the "permanent server-side redirect" Google recommends when an address changes (Google Search Central: Redirects and Google Search).

FAQ

Does Contentful add title tags and meta descriptions by itself?

No. Contentful stores the text, and the site's code must print it into the page. Check the page source of a few pages to confirm.

Does a headless CMS make a site faster?

Not by itself. Speed depends on how the front end builds pages and handles images; a browser-built page can be slower than a plain site builder.

Do I need a sitemap for a small Contentful site?

Google says a site of about 500 pages or fewer, well linked internally, might not need one. On a headless site nothing makes one automatically, so ask the developer to generate it from your slugs if you want one.

Can I change a page's slug in Contentful?

Yes, but the old address breaks unless a 301 redirect is set up in the site code or at the host. Change slugs only when you must.

Different for you?

Keep learning

NextIs Wix or Squarespace bad for SEO? Choosing a website platformWix, Squarespace or WordPress for SEO: what Google requires, what each platform lets you control, and what you can take with you if you leave.

Do it yourself

Webflow SEO checklist: every setting to check, and where it isA Webflow SEO checklist for a small business site: where each on-page, technical and local setting lives in Webflow, and what Google actually requires.

Ask us one question

One line is enough. We reply by email.

Sources

  1. Contentful Docs: Compose content model and SEO
  2. Contentful Docs: Experience reference fields for metadata
  3. Contentful Docs: Experiences overview
  4. Contentful Docs: Content types (field validations)
  5. Contentful Docs: Images API
  6. Contentful Docs: Technical limits
  7. Contentful Docs: Webhooks overview
  8. Contentful: Pricing (as archived July 2026)
  9. Google Search Central: Understand the JavaScript SEO basics
  10. Google Search Central: Dynamic rendering as a workaround
  11. Google Search Central: Meta tags and attributes that Google supports
  12. Google Search Central: Redirects and Google Search
  13. Google Search Central: What is a sitemap
  14. Google Search Central: Understanding page experience
  15. Google Search Central: About AMP on Google Search
  16. PageSpeed Insights: About PageSpeed Insights
  17. web.dev: Optimize Largest Contentful Paint
  18. web.dev: Browser-level image lazy loading
  19. Vercel and MERJ: The rise of the AI crawler (December 2024)