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
altattributes 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
- Go to the Theme Check tab in your scan results and switch between the Errors and Warnings tabs.
- Fix errors first — they carry the highest per-issue penalty.
- Group issues by check type using the accordion view to tackle entire categories at once.
- 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.