How the theme score is calculated

The theme score reflects the overall code quality of your active Shopify theme, based on the results of a full Shopify Theme Check run. It starts at 100 and loses points for every error and warning found.

Scoring formula

Finding type	Deduction per issue
Errors (first 100)	−0.5 points each
Errors (101–300)	−0.25 points each
Errors (301+)	−0.125 points each
Warnings	−0.1 points each

The score is clamped between 0 and 100. A store with zero errors and zero warnings scores 100.

Example: 80 errors + 50 warnings → 100 − (80 × 0.5) − (50 × 0.1) = 100 − 40 − 5 = 55

What counts as an error vs. a warning

Errors are violations of Shopify’s theme rules that can cause rendering failures, broken functionality, or app review rejections. Common examples include:

• Invalid Liquid syntax
• References to non-existent snippets or sections
• Missing required schema fields
• Deprecated Liquid filters used in a way that will break

Warnings are best-practice violations that don’t break the theme today but may cause issues in the future or indicate technical debt:

• Unused CSS or JavaScript includes
• Large inline <style> blocks
• Missing alt attributes on images
• Deprecated but still-functional syntax

Weight in the overall health score

The theme score contributes 30% of the total store health score — the largest single weight. This reflects how central theme quality is to storefront stability and performance.

How to improve your score

1. Go to the Theme Check tab in your scan results and switch between the Errors and Warnings tabs.
2. Fix errors first — they carry the highest per-issue penalty.
3. Group issues by check type using the accordion view to tackle entire categories at once.
4. Use the Learn more link next to each issue type for Shopify’s official documentation.

Most stores can move from a poor score to a healthy one by fixing the top 2–3 error categories, which tend to account for the majority of issues.