SuperSchema

Documentation

Everything you need to know about using SuperSchema

Table of Contents

Getting Started

Welcome to SuperSchema

SuperSchema is an AI-powered tool that automatically generates schema markup (JSON-LD) for your website. Schema markup helps search engines and AI tools like ChatGPT, Perplexity, and Google AI Overviews better understand your content, leading to better rankings and visibility.

Quick Start Guide

  1. Sign up for a free account (you'll get 2 free credits to start)
  2. Go to the Generate page
  3. Paste a URL or use URL Discovery to crawl your website
  4. Click "Generate Schema" and watch the AI work its magic
  5. Copy the generated JSON-LD code and add it to your website's <head> section

Pro Tip: Start with your most important pages (homepage, product pages, blog posts) to see the biggest impact on your search visibility.

URL Discovery

What is URL Discovery?

URL Discovery is our website crawler that automatically finds all the pages on your website. Instead of manually entering URLs one by one, just drop in your domain and let us do the heavy lifting.

How to Use URL Discovery

  1. Go to the Generate page
  2. Find the "URL Discovery" section at the top
  3. Enter your domain (e.g., example.com)
  4. Click "Discover URLs"
  5. Wait while our crawler finds all your pages (usually takes 10-30 seconds)
  6. All discovered URLs are automatically saved to your Library

What Gets Discovered?

Our crawler finds:

  • All pages linked from your homepage
  • Blog posts and articles
  • Product pages
  • Category and archive pages
  • Static pages (about, contact, etc.)

Note: URL Discovery finds pages that are publicly accessible and linked from other pages. It won't find pages that require login or aren't linked anywhere.

Schema Generation

How Schema Generation Works

SuperSchema uses AI to analyze your webpage and automatically generate the correct schema markup. No manual data entry, no Schema.org documentation hunting—just paste a URL and go.

Generating Your First Schema

  1. Navigate to the Generate page
  2. Enter a URL in the "URL to Generate Schema" field
  3. Click "Generate Schema"
  4. The AI will analyze your page (takes 5-15 seconds)
  5. Review the generated schema in the editor
  6. Copy the HTML script tags or push directly to HubSpot

Supported Schema Types

SuperSchema automatically detects and generates:

  • Article: Blog posts, news articles, guides
  • BlogPosting: Blog posts specifically
  • Product: E-commerce products with prices, reviews
  • LocalBusiness: Physical businesses with locations
  • Organization: Company information
  • Person: Author bios, team member pages
  • Event: Conferences, webinars, meetups
  • Recipe: Food recipes with ingredients and instructions
  • FAQPage: FAQ sections
  • HowTo: Step-by-step guides
  • WebPage: Generic web pages
  • ...and more!

What the AI Extracts

SuperSchema automatically pulls:

  • Titles, headings, and content
  • Author information
  • Publication dates
  • Images and media
  • Product prices and availability
  • Ratings and reviews
  • Business hours and contact info
  • Event dates and locations

Accuracy: Our AI reads your actual page content, so the schema is based on real data—not generic templates or hallucinations like you'd get from ChatGPT.

Schema Quality & Refinement

Understanding Quality Scores

Every schema gets a quality score from 0-100 based on completeness, accuracy, and best practices. Higher scores mean better chances of rich snippets and AI citations.

Quality Score Breakdown

90-100

Excellent

Complete, optimized schema with all recommended properties

70-89

Good

Solid schema with most important properties present

50-69

Fair

Basic schema, missing some recommended properties

0-49

Needs Work

Minimal schema, consider using AI refinement

AI Refinement

Use AI refinement to automatically improve your schema quality score. The AI analyzes your schema and adds missing properties, fixes issues, and optimizes for search engines.

Refinement Limits: You can refine each schema up to 2 times

Cost: Refinements are FREE (included with your schema generation)

Results: Average quality score improvement of 15-25 points

How to Use Refinement

  1. Generate or view a schema from your Library
  2. Check the quality score in the "Schema Quality" section
  3. Click "Refine with AI" button (shows remaining refinements)
  4. Wait 10-20 seconds for the AI to optimize your schema
  5. Review the changes highlighted in the results
  6. Check the improved quality score

When to Refine: Refine schemas with scores below 80, or when you need that extra edge for competitive keywords and AI citations.

Library Management

Your Schema Library

The Library is your central hub for managing all URLs and their schemas. Every URL you discover or generate schema for is automatically saved here.

Library Features

  • Organize by Domain: URLs are automatically grouped by domain
  • Filter by Schema Status: View all URLs, only those with schema, or those needing schema
  • Search: Quickly find URLs by searching paths or domains
  • Hide/Unhide URLs: Keep your library clean by hiding URLs you don't need
  • Bulk Delete: Select multiple URLs and delete them at once
  • Live Editor: View and edit schema directly from the Library

Library Workflow

  1. Discover URLs or generate schema for individual pages
  2. Review URLs in your Library (filter by "Needs Schema")
  3. Click on URLs without schema to quickly generate from the Library
  4. Edit and refine schemas as needed
  5. Push to HubSpot or copy code for manual implementation
  6. Hide or delete URLs you no longer need

Tip: Use the Library filters to track your schema coverage. The "Has Schema" vs "Needs Schema" tabs show exactly which pages still need attention.

HubSpot Integration

Push Schema to HubSpot

Connect your HubSpot account to automatically push schema markup directly to your HubSpot blog posts, pages, and landing pages. No manual copy-paste required.

Connecting HubSpot

  1. Go to the HubSpot page in SuperSchema
  2. Click "Connect HubSpot Account"
  3. Log in to your HubSpot account and authorize SuperSchema
  4. You'll be redirected back to SuperSchema with your portal connected

Domain Association

If you have multiple HubSpot portals, associate domains with each portal for automatic selection:

  1. Go to the HubSpot page
  2. Find your connected portal
  3. In the "Associated Domains" section, click "Add Domain"
  4. Enter the domain that's hosted in this HubSpot portal
  5. Click "Add"

Pushing Schema to HubSpot

  1. Generate schema for a URL (or open it from your Library)
  2. Click "Push to HubSpot" button
  3. Select the matching HubSpot content (blog post, page, or landing page)
  4. Click "Push Schema"
  5. Schema is automatically added to your page's head HTML

Requirements: HubSpot integration requires Marketing Hub Professional/Enterprise or CMS Hub Professional/Enterprise.

Troubleshooting

Getting "Domain Not Associated" warning?

This means you have multiple HubSpot portals and haven't associated domains yet. Follow the Domain Association steps above, or click "Go to HubSpot Settings" in the modal.

Can't find my HubSpot page?

Make sure the URL domain matches your HubSpot domain. The content matcher searches by URL, so the domains must match exactly.

Connection showing as "Inactive"?

Click "Validate" to refresh the connection. If it stays inactive, you may need to reconnect your HubSpot account.

Credits & Billing

How Credits Work

SuperSchema uses a credit-based system. Each action that uses AI (like generating schema) costs 1 credit. No subscriptions, no monthly fees—just pay for what you use.

What Costs Credits?

  • 1 credit Generating schema for a URL

What's FREE?

  • URL Discovery (crawling your website)
  • Saving URLs to your Library
  • Editing schema manually
  • Viewing and managing your Library
  • 2 free AI refinements per schema (improves quality automatically)
  • Pushing schema to HubSpot
  • Copying schema code

Free Credits

New users get 2 free credits when they sign up. No credit card required.

Purchasing Credits

  1. Go to the Credits page
  2. Click "Purchase Credits"
  3. Choose a credit pack (larger packs = better value)
  4. Complete checkout with Stripe
  5. Credits are added instantly

Checking Your Balance

  • View your credit balance on the Dashboard
  • See detailed transaction history on the Credits page
  • Get low balance warnings when you have less than 5 credits

Value: Credits never expire, and you only pay for AI-powered features. Manual editing and organization are completely free.

Schema Implementation

Adding Schema to Your Website

Once you've generated schema, you need to add it to your website. SuperSchema generates JSON-LD format, which is the easiest and most recommended method by Google.

HubSpot (Automatic)

If you use HubSpot, use our integration to push schema automatically:

  1. Connect your HubSpot account
  2. Generate schema
  3. Click "Push to HubSpot"
  4. Done! Schema is added to your page's head

WordPress

  1. Copy the schema script tags from SuperSchema
  2. Install a plugin like "Insert Headers and Footers" or "Code Snippets"
  3. Paste the schema in the "Head" section for that specific page
  4. Save and publish

Shopify

  1. Copy the schema script tags
  2. Go to your Shopify admin → Online Store → Themes
  3. Click "Actions" → "Edit code"
  4. Find your page template (e.g., product.liquid, article.liquid)
  5. Paste the schema before the closing </head> tag
  6. Save the file

Webflow

  1. Copy the schema script tags
  2. In Webflow, go to your page settings
  3. Scroll to "Custom Code" section
  4. Paste the schema in "Head Code"
  5. Save and publish

Custom HTML / Other Platforms

  1. Copy the complete schema script tags from SuperSchema
  2. Open your HTML file or page template
  3. Paste the schema inside the <head> section, before the closing </head> tag
  4. Save and deploy your changes

Verify Your Schema

After adding schema to your site:

  1. Go to Google's Rich Results Test: search.google.com/test/rich-results
  2. Enter your page URL
  3. Click "Test URL"
  4. Check for any errors or warnings
  5. If valid, you're all set!

Best Practice: Always test your schema after adding it to your site. Google's Rich Results Test will catch any formatting issues and show you exactly what search engines see.

Frequently Asked Questions

Why isn't my schema showing up in search results?

Schema doesn't guarantee rich snippets—it just makes them possible. Google needs to: (1) crawl and index your page, (2) validate your schema, and (3) decide your content deserves a rich snippet. This can take days or weeks. Keep your schema valid, content high-quality, and be patient.

Can I edit the schema after generating it?

Absolutely! The schema editor lets you manually edit any field. Just be careful not to break the JSON structure. If you mess up, you can always regenerate or use AI refinement.

What if I run out of credits?

You can still access all your existing schemas, edit them manually, and manage your Library. You just won't be able to generate new schemas or use AI refinement until you purchase more credits.

Do credits expire?

Nope! Credits never expire. Buy them whenever you need them, use them whenever you want.

Can I get a refund?

Credit purchases are non-refundable, but we're confident you'll love the results. Start with the 2 free credits to test it out before purchasing.

Is my data secure?

Yes. We use industry-standard encryption for all data. Your HubSpot tokens are encrypted at rest, and we never store your payment information (handled by Stripe).

Can I cancel my account?

There's no subscription to cancel. Just stop using SuperSchema whenever you want. Any unused credits will remain in your account if you decide to come back.

Does SuperSchema work for e-commerce?

Yes! SuperSchema automatically detects Product schema for e-commerce pages, including price, availability, reviews, and ratings. Works with Shopify, WooCommerce, and any other platform.

What's the difference between SuperSchema and other schema tools?

Most schema tools give you generic templates that require manual data entry. SuperSchema actually visits your URL, reads your real content, and generates complete, accurate schema automatically. Plus, we have quality scoring, AI refinement, and HubSpot integration built in.

Can I use SuperSchema for client work?

Absolutely! Agencies and freelancers use SuperSchema to quickly generate schema for client sites. Just generate the schema and add it to your client's website—no special license needed.

Still have questions?

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

Contact Support