Every schema SuperSchema generates comes with a quality score from 0 to 100. It grades that one schema: how complete it is and how well its properties are built. A higher score means better markup, which gives you a better shot at rich results and AI citations. You will see it above the editor as a "Schema Quality Overview" with two dimensions, Completeness and Quality Depth, plus a grade and a list of specific things you can improve.
The two dimensions #
- Completeness
- Whether the right properties are present at all: the required basics, the recommended properties search engines look for, advanced AEO properties, and content-quality signals. This is the headline 0 to 100 score.
- Quality Depth
- How well the properties you do have are implemented: are values structured as proper objects, are descriptions the right length, are entities disambiguated, is media richly described. This is the dimension that AI refinement is designed to raise.
How Completeness is calculated #
The Completeness score is a weighted blend of four factors, then adjusted by a schema.org compliance bonus or penalty:
| Factor | Weight | What it checks |
|---|---|---|
| Required properties | 35% | The must-haves: @context, @type, and a name or headline. |
| Recommended properties | 25% | Properties like description, url, image, author, publisher, datePublished, and dateModified. |
| Advanced AEO features | 25% | Properties that help AI understand context, such as keywords, about, mentions, sameAs, and inLanguage. |
| Content quality | 15% | Signals like a well-sized description, a structured author and publisher, and real images. |
On top of that weighted average, a schema.org compliance check adds a small bonus when your markup is clean and applies a penalty when it has validation errors. A fully compliant schema earns a couple of bonus points; a schema with several compliance errors can lose more, because invalid markup can fail validation entirely.
What the score bands mean #
| Score | Band | What it means |
|---|---|---|
| 90 to 100 | Excellent | Complete, well-built markup with strong AEO coverage. |
| 75 to 89 | Good | A solid schema with most important properties in place. |
| 60 to 74 | Fair | A workable start that is missing some recommended properties. |
| Below 60 | Needs Improvement | Minimal markup. Start with the critical action items and consider refining. |
Refine with AI #
Refine with AI is a one-click pass that improves the current schema for you. It is designed to raise Quality Depth: converting plain string values into structured objects, tuning the description to the ideal length, adding safe AEO properties like inLanguage, and enriching media and entity data using content already found on your page. It never invents facts such as authors or dates that were not verified on the page, and it preserves the existing properties rather than stripping them out.
- You get up to two free AI refinements per schema.
- The button shows how many refinements you have left, and the results banner lists each change it made.
- New or changed properties are highlighted in the editor so you can see exactly what moved.
- Open a schema from your Library, or generate a new one.
- Check the score in the Schema Quality Overview.
- Click "Refine with AI". The button shows your remaining refinements.
- Wait a few seconds while the AI enhances the schema.
- Review the highlighted changes and the updated score, then edit further by hand if you want.
When you run out of refinements #
After two AI passes on a schema, the Refine with AI button is replaced with a note saying you have used all your refinements. You can still improve the schema: edit it by hand in the editor to add recommended properties, or generate a fresh schema for the page to start a new pair of refinements.