AI-Readable View // This is what AI systems see
Download .md Download .txt 
# Schema quality score and AI refinement

> Every schema you generate gets a per-schema quality score from 0 to 100, shown as a Schema Quality Overview with two parts: Completeness and Quality Depth. Refine with AI gives you up to two free passes that mainly raise Quality Depth. This is separate from your site SuperSchema Score.

*Category: Generating Schema ยท Last updated: 2026-07-07*

---

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.

> **Note:** This per-schema quality score is not your SuperSchema Score. The SuperSchema Score is a separate, site-wide measure of how ready your whole website is for AI, scored across five categories. The quality score here grades a single piece of schema markup.

### 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. |

> **Note:** The Overview also surfaces Strengths, Priority Action Items (each tagged with an estimated point impact and rough effort), and Improvement Suggestions. Working through the critical action items is the fastest way to move the score.

### 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.

1. Open a schema from your Library, or generate a new one.
2. Check the score in the Schema Quality Overview.
3. Click "Refine with AI". The button shows your remaining refinements.
4. Wait a few seconds while the AI enhances the schema.
5. Review the highlighted changes and the updated score, then edit further by hand if you want.

> **Tip:** Refinement is most valuable on schemas scoring below the Good band. On a schema that is already strong, the first pass tends to deliver the biggest jump, and a second pass mostly adds smaller safe properties rather than a large score change.

> **Note:** Because refinement targets Quality Depth and safe enhancements, the headline Completeness number sometimes moves less than you might expect, especially on schemas that are already well-built. That is by design: it will not fabricate missing facts just to inflate the number.

### 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.

## Questions this answers

- What does my schema quality score mean?
- What is the difference between Completeness and Quality Depth?
- How is the schema quality score calculated?
- How do I improve my schema quality score?
- How many times can I refine a schema with AI?
- What does Refine with AI actually change?
- Why did my score barely move after refining?
- Is the schema quality score the same as my SuperSchema Score?

## Related

- https://superschema.ai/docs/schema-generation
- https://superschema.ai/docs/editing-schema
- https://superschema.ai/docs/schema-implementation
- https://superschema.ai/docs/your-superschema-score