Skip to main content
Scores are the core output of every analysis in ScreenScore AI. When you submit a screen for analysis, the API returns a composite score between 0 and 100 along with a breakdown across five independent dimensions. Each dimension targets a specific aspect of visual performance, giving you actionable signal rather than a single opaque number.

​
The overall score

The overall score is a weighted composite of all five dimension scores. It gives you a single at-a-glance indicator of how well your screen is likely to perform with users.
score object
{
  "score": 78,
  "breakdown": {
    "visual_clarity": 82,
    "visual_hierarchy": 75,
    "color_contrast": 88,
    "cta_effectiveness": 71,
    "brand_consistency": 74
  }
}

​
Score ranges

Use these ranges to interpret results and prioritize improvements.
RangeLabelWhat it means
0–40Needs ImprovementSignificant issues are likely hurting user engagement or accessibility.
41–70GoodThe screen is functional but has clear opportunities to improve.
71–85GreatStrong performance with minor areas to refine.
86–100ExcellentTop-tier visual quality with minimal issues detected.

​
Scoring dimensions

Each dimension is scored independently on a 0–100 scale. You can act on any dimension without needing to improve the others.
Visual Clarity measures how easily users can process the content at a glance. A high score means your layout is clean and scannable; a low score typically signals cluttered elements, insufficient whitespace, or poor text legibility.Factors evaluated:
  • Element density and visual noise
  • Whitespace distribution
  • Text size, weight, and legibility
Common improvements: Reduce the number of competing elements in a single view, increase line-height and padding around text, and use a minimum body text size of 16px.
Visual Hierarchy measures how well the design guides users’ attention through the screen in an intentional order. A high score means primary content and actions are immediately obvious; a low score suggests that too many elements compete for attention at the same visual weight.Factors evaluated:
  • Size contrast between primary, secondary, and tertiary elements
  • Positioning and reading flow
  • Focal points and directional cues
Common improvements: Increase the size difference between headings and body text, use visual weight (bold, color, scale) to signal importance, and ensure the primary CTA is the most visually prominent interactive element on the page.
Color & Contrast evaluates both accessibility and visual impact. A high score means your color choices meet WCAG standards and create a coherent, appealing palette; a low score may indicate contrast failures that reduce readability or color combinations that clash.Factors evaluated:
  • WCAG 2.1 contrast ratios for text and interactive elements
  • Color harmony and palette cohesion
  • Use of color to reinforce hierarchy and meaning
Common improvements: Ensure all body text meets a minimum 4.5:1 contrast ratio against its background, and verify interactive elements meet 3:1. Limit your primary palette to 3–4 colors.
CTA Effectiveness measures how compelling and visible your calls-to-action are. A high score means users can immediately locate and understand what action to take; a low score often reflects buttons that blend into the background, weak copy, or poor placement.Factors evaluated:
  • Button size and tap/click target area
  • Color differentiation from surrounding content
  • Copy clarity and action orientation
  • Placement relative to supporting content
Common improvements: Use a distinct, high-contrast button color not used elsewhere on the screen, write copy in verb-first imperative form (“Start free trial” rather than “Free trial”), and position the primary CTA above the fold.
Brand Consistency measures how well the screen aligns with your established brand patterns. This dimension requires a brand profile to be configured on your project or organization.Factors evaluated:
  • Logo presence and placement
  • Typography alignment with brand type scale
  • Color usage against approved brand palette
  • Spacing and layout pattern adherence
If no brand profile is set, this dimension will return null and is excluded from the composite score calculation. See your organization settings to configure a brand profile.
Common improvements: Ensure primary typefaces match the brand type scale exactly, and cross-check button and link colors against your approved palette before submission.

​
Retrieving scores

Scores are returned as part of an analysis result. To learn how to submit a screen for analysis and retrieve the full score breakdown, see Analyses.
You can compare scores across multiple analyses in the same project to track improvements over time. See Projects for details on organizing analyses.