Fix guide · Webflow

How to Add JSON-LD Schema Markup to Webflow (2026)

Webflow doesn't generate JSON-LD structured data automatically — you need to add it via custom code embeds. Without schema markup, search engines and AI models have less structured context about your content, and you miss out on rich results (star ratings, FAQ dropdowns, how-to steps) in Google.

Run a free check to confirm this is affecting your site

Why it matters

What this issue costs you

JSON-LD schema helps Google understand your content type (article, product, FAQ, how-to) and can unlock rich results that dramatically increase click-through rates. It's also a signal for AI retrieval systems: FAQPage and HowTo schema are weighted in citation selection by engines like Perplexity and ChatGPT.

Step-by-step

How to fix: Missing or incomplete JSON-LD schema

Webflow

1
Add schema to a static page
In the Webflow Designer, select the page body or a section. Add an Embed element (from the Add panel > Components > Embed). Paste your JSON-LD script. The embed will appear as a grey code block in the Designer but renders as invisible structured data on the published site.
Embed element (Organization schema)
```
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Your Company",
  "url": "https://yourdomain.com",
  "logo": "https://yourdomain.com/logo.png",
  "sameAs": [
    "https://twitter.com/yourhandle",
    "https://linkedin.com/company/yourcompany"
  ]
}
</script>
```

Add Article schema to blog posts (CMS)

For CMS collection pages: open the collection template in the Designer. Add an Embed element inside the template. Use Webflow CMS field bindings to populate the schema dynamically. In the embed code, reference CMS fields with the purple "Add Field" option.

Embed in collection template (replace YOUR_ fields with CMS bindings)

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "YOUR_TITLE_FIELD",
  "description": "YOUR_SUMMARY_FIELD",
  "datePublished": "YOUR_PUBLISHED_DATE_FIELD",
  "dateModified": "YOUR_UPDATED_DATE_FIELD",
  "author": {
    "@type": "Person",
    "name": "YOUR_AUTHOR_FIELD"
  },
  "publisher": {
    "@type": "Organization",
    "name": "Your Company",
    "url": "https://yourdomain.com"
  }
}
</script>

Add FAQPage schema

For pages with FAQ sections, add an Embed element after your FAQ content with FAQPage schema. Each question-answer pair is a mainEntity item. This enables FAQ rich results in Google (expandable answers directly in search results).

Embed element (FAQPage schema)

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Your question here?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Your answer here."
      }
    },
    {
      "@type": "Question",
      "name": "Second question?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Second answer."
      }
    }
  ]
}
</script>

4
Validate your schema
After publishing, test your schema with Google's Rich Results Test (search.google.com/test/rich-results). Paste your page URL and check for errors. Common issues: missing required fields, incorrect date formats (use ISO 8601: YYYY-MM-DD), and unescaped quotes in CMS text fields.

Verify the fix

Run the checker to confirm the issue is resolved

After applying the steps above, paste your URL below. Our checker will re-run every applicable check and show whether missing or incomplete json-ld schema still shows as a failing check.

FAQ

Common questions about missing or incomplete json-ld schema

Does Webflow add any structured data automatically?

Webflow adds basic Open Graph and Twitter Card meta tags based on your SEO settings, but it does NOT generate JSON-LD structured data. All schema markup must be added manually via Embed elements or custom code in Project Settings.

Can I use Webflow CMS fields inside JSON-LD embeds?

Yes. In an Embed element on a collection template, click "Add Field" to insert CMS values. Webflow replaces them with the actual field values when the page renders. Be careful with rich text fields — they may contain HTML that breaks the JSON. Use plain text fields for schema.

Where should I place the JSON-LD embed in Webflow?

Place it anywhere in the page body — JSON-LD doesn't need to be in the <head>. Best practice: add it at the bottom of the page content, inside a section that won't be accidentally deleted during layout changes. Alternatively, add site-wide schema (Organization) in Project Settings > Custom Code > Head Code.

While you're here

Related fix guides for Webflow

Missing or invalid JSON-LD schemaWordPress→Missing or incomplete JSON-LD schemaShopify→Missing meta descriptionWebflow→

Need a full audit?

This checker spots individual issues instantly. deepseoanalysis.com crawls your whole site and tracks changes weekly, from $24/mo.

Deep audit →

See all WordPress fix guides, or run a free check now.