Deploying Schema

Adding schema to your website

Once your schema is generated, add the JSON-LD to your page's <head>. Step-by-step guides for HubSpot, WordPress, Shopify, Webflow, and custom HTML, plus how to verify it went live.

View as plain text Updated 2026-07-07

Once you have generated schema, you add it to your website. SuperSchema produces JSON-LD, an inline <script type="application/ld+json"> block that goes in your page's <head>. JSON-LD is the format Google recommends, and it does not change how your page looks. The steps below cover the common platforms; if yours is not listed, the custom HTML steps apply.

Note Whatever platform you use, paste the block on the specific page the schema was generated for, not site-wide. Each page needs its own accurate schema.

HubSpot (one-click push) #

If you use HubSpot, you do not need to copy or paste anything. Connect your portal and let SuperSchema place the schema for you.

  1. Connect your HubSpot portal from the HubSpot settings (or you will be prompted the first time you deploy).
  2. Generate schema for the page.
  3. Click "Deploy to HubSpot".
  4. Pick the matching HubSpot content item (blog post, page, landing page, or knowledge article) when prompted.
  5. Done. SuperSchema inserts the block into that content item's head. The button changes to "Redeploy to HubSpot" for future updates.
Note See HubSpot integration for connecting a portal, matching content, and reconnecting if your authorization expires.

WordPress #

  1. In SuperSchema, copy the block ("Copy schema for <head>" or "Copy everything for <head>").
  2. Install a header/footer plugin such as "Insert Headers and Footers" or "Code Snippets" (or use your theme's per-page head-code field if it has one).
  3. Paste the block into the "Head" or "Scripts in Header" area for that specific page or post.
  4. Save and publish.
Tip Many WordPress SEO plugins add a site-wide header field. Use a per-page option where you can, so each page gets only its own schema.

Shopify #

  1. In SuperSchema, copy the block.
  2. Go to your Shopify admin, then Online Store, then Themes.
  3. Click "Actions", then "Edit code".
  4. Open the template for that page (for example product.liquid or article.liquid), or theme.liquid for the shared <head>.
  5. Paste the block before the closing </head> tag.
  6. Save the file.

Webflow #

  1. In SuperSchema, copy the block.
  2. In Webflow, open the settings for that specific page.
  3. Scroll to the "Custom Code" section.
  4. Paste the block into "Inside <head> tag".
  5. Save and publish your site.

Custom HTML or another platform #

  1. In SuperSchema, copy the full block.
  2. Open your HTML file or page template.
  3. Paste the block inside the <head>, before the closing </head> tag.
  4. Save and deploy your changes.

The SuperSchema markers #

The copied block is wrapped in two HTML comment lines. Leave them in place; they let SuperSchema recognize which exact version is live when it verifies and monitors the page.

html
<!-- SuperSchema v="2" id="..." ts="..." types="..." -->
<script type="application/ld+json">
{ "@context": "https://schema.org", "@type": "Article", "headline": "..." }
</script>
<!-- /SuperSchema -->
Note Removing the comment markers does not stop search engines from reading your schema, but it does stop SuperSchema from confirming the page is current or alerting you when the schema drifts.

Verify your schema #

After you deploy, confirm the schema is actually live. The fastest way is Verify inside SuperSchema, which fetches your page as the SuperSchemaBot crawler and checks that the current version is present. You can also use Google's free tool:

  1. Go to Google's Rich Results Test at search.google.com/test/rich-results.
  2. Enter your page URL.
  3. Click "Test URL".
  4. Check for any errors or warnings and confirm your schema types are detected.
Tip Always verify after deploying. Verification in SuperSchema also unlocks page monitoring on paid plans, so you get alerted if the schema later breaks or disappears. See How verification works for details.

Still have questions?

Can't find what you're looking for? Our support team is here to help.

Contact Support