Glossary · AI Search & Prompting

Recommended Format for Schema Markup

JSON-LD is usually the recommended format for schema markup because it separates structured data from visible page code and is easier to maintain.
Back to glossary

The recommended format for implementing schema markup is usually JSON-LD, a block of structured data placed in a script element with the type application/ld+json. Search engines can read the block without requiring the markup to wrap every visible heading, image, price, author name, or review on the page.

JSON-LD is a format, while Schema.org supplies the vocabulary. A team may use JSON-LD to state that a page contains an Article, Organization, Product, Event, or another defined entity. Microdata and RDFa can also express Schema.org properties, but JSON-LD is generally easier for marketing and development teams to generate, review, and update across templates.

How schema markup implementation works in practice

A durable implementation starts with the page and its visible claims. The schema should describe what a visitor can actually find, use the most specific supported type, and keep important identifiers consistent across the site. The work belongs in the publishing system rather than in a one-time code snippet pasted into a handful of pages.

  1. Choose the entity represented by the page. An article page may need Article or BlogPosting markup, while a company page usually needs Organization. Do not choose a type only because it has an attractive search feature.
  2. Map visible facts to valid properties. Use the page title, canonical URL, author, dates, image, logo, offer, or other facts that the page already presents. Leave out properties the team cannot support or keep current.
  3. Generate a JSON-LD block and place it in the page template. The script can appear in the head or body, but it should render reliably for crawlers and should not depend on a visitor action to load.
  4. Validate the syntax and the search feature requirements. A Schema.org validator can catch vocabulary errors, while a search engine's rich-result test can show whether a supported enhancement is eligible and which recommended fields are missing.
  5. Monitor production pages after release. Check rendered HTML, indexing reports, enhancement reports, template changes, and visible page data. Update the markup whenever the underlying claim changes.

Success has two layers. The first is technical: valid JSON-LD appears on every intended canonical page and stays synchronized with visible content. The second is search behavior: eligible pages may gain enhanced presentation, clearer entity interpretation, or fewer markup errors. Rich results remain a search-engine choice, so eligibility should never be reported as guaranteed display.

How to keep the process accountable

Treat schema markup implementation as part of the publishing contract. The page, canonical metadata, structured graph, sitemap, internal links, and source records should describe the same entity without relying on a plugin operator to reconcile them manually. Keep a small fixture set for major page templates and run it after CMS, rendering, URL, schema, and design changes. Record warnings separately from errors so optional properties do not become a reason to invent content or delay useful releases.

Keep the smallest useful scope for schema markup implementation until the operation has evidence to expand. Limit templates, segments, permissions, channels, or actions at first. Review errors and manual work, then add scope deliberately. This makes ownership and rollback practical and gives the team a baseline against which a broader version can be judged. The final artifact should show the current decision, the evidence behind it, and the condition that forces reconsideration. That is what makes schema markup implementation maintainable after the original operator moves to another project.

Retirement belongs in the operating plan for schema markup implementation too. Define the signal that shows the process no longer serves its original audience, system, category, or decision. Archive the configuration and evidence, stop new entries safely, preserve required history, and update dependent reports or links. Unused processes create risk when they remain active simply because no one owns turning them off. Record where schema markup implementation remains uncertain and when that uncertainty becomes material. This gives the next operator a starting point instead of forcing another full audit.

What teams need to decide

  • Decide which page templates deserve markup and which entity each template represents.
  • Assign ownership for business facts such as prices, dates, authors, logos, and ratings.
  • Define whether the CMS, a tag manager, or application code will generate the JSON-LD.
  • Set a validation gate for publishing and a monitoring process for production errors.
  • Document exceptions, especially pages that contain several entities or change frequently.

The best location for the implementation is the place where the source facts already live. Product data should flow from the product record, author data from the author profile, and dates from the publishing system. Copying those facts into a separate spreadsheet makes drift almost inevitable.

A common failure mode

A common failure is treating schema as invisible SEO copy. The team fills every possible property, repeats keywords, marks up reviews that are not displayed, or adds types that do not match the page. The code may validate syntactically while still misrepresenting the content. Another version of the same problem appears when a redesign changes the page and leaves the old JSON-LD untouched.

Recover by reducing the block to verified page facts, connecting each property to a maintained source, and testing the rendered production URL. A smaller accurate graph is more useful than a large brittle one.

Set up once

See what Surface can do for your team.

Get a walkthrough