How do I add custom JSON-LD to a Wix page?

Definition: Custom JSON-LD on a Wix page is structured data, meaning machine-readable information describing that page, added through its Advanced SEO settings. JSON-LD expresses this information in a script block using JSON notation.

As of 17 October 2026, Wix's SEO settings documentation provides the page-level route below. Google's structured data introduction describes JSON-LD as notation embedded in a script element.

Key facts

• Wix's markup instructions accept JSON-LD and specify fewer than 7,000 characters per markup, with up to five markups per page.
• Wix's troubleshooting guide requires opening and closing script tags and gives a total page allowance of 8,000 markup characters.
• Wix's SEO settings guide places structured data under the Advanced tab for an individual main page.

Where is the page's markup setting?

Wix's SEO settings guide documents this dashboard route for a static main page:

1. Open SEO & GEO in the site's dashboard.
2. Under Tools and settings, open SEO Settings.
3. Under Edit by page type, select Main Pages.
4. Open Edit by Page and select the relevant page.
5. In the panel on the right, open Advanced, then Structured data markup.

The same guide distinguishes settings applied to an entire page type from changes to an individual page. Selecting the specific page keeps this workflow at page level.

What goes in the new markup block?

Wix's adding markup instructions specify + Add New Markup, a name for the markup, the Write your markup in JSON-LD format field, and Apply.

The following is a template using Schema.org's WebPage type, whose properties include name and url. PAGE_TITLE and the example address are placeholders to replace with the actual page title and address.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "WebPage",
  "name": "PAGE_TITLE",
  "url": "https://example.com/page"
}
</script>

Wix's troubleshooting instructions require one script tag and one main markup type per block. They also require straight quotation marks and commas between JSON fields, with no trailing comma after the last field. HTML tags inside the JSON-LD cause validation failure.

Google's structured data introduction requires the markup to describe the page's content and information visible to visitors. The template therefore needs values that accurately describe the target page.

How is the change published and checked?

After applying the block, Wix's individual-page SEO workflow ends with Publish. This completes the documented dashboard workflow.

Wix's markup management instructions provide Edit, Test on Google, and Remove through the markup's Show More menu. Rich results are special search-result features; the test checks eligibility for them.

Google's Rich Results Test help supports testing a full page URL or pasted code. Results identify detected rich-result types and errors or suggestions. The URL test requires page resources to be accessible to an anonymous internet visitor.

Related terms

• Structured data
• JSON-LD
• How do I edit Wix's preset structured data markup?
• How do I troubleshoot structured data errors in Wix?

FAQ

Can I use this workflow for a dynamic page?

Wix's adding markup article limits its workflow to static pages. For Wix Stores product pages, you can use the separate SEO Settings route described in the same article.

Why does Wix reject code that passes Google's test?

Wix's troubleshooting guide addresses this situation: check the JSON-LD format, script wrapper, punctuation and field line breaks. Each field must remain on a single line.

Can I test the markup before publishing?

Google's Rich Results Test help lets you choose Code and paste a snippet. You can edit it and run the test again.

Sources

1. Wix, "Add Structured Data Markup to Your Site's Pages", undated
2. Wix, "Customizing Your SEO Settings", undated
3. Wix, "Troubleshooting Your Structured Data Markup", undated
4. Schema.org, "WebPage", undated
5. Google Search Central, "Introduction to structured data markup in Google Search", undated
6. Google Search Console Help, "Rich Results Test", undated

---

Check how a page reads to answer engines. Open the GEO score analyzer