Brandlint Docs
Understanding Results

Scores Explained

How Brandlint calculates brand consistency scores.

Every PR receives a score from 0 to 100 indicating how well your copy aligns with your brand guidelines.

Score ranges

ScoreRatingWhat it means
90-100ExcellentCopy is highly consistent with guidelines
70-89GoodMinor improvements possible, generally solid
50-69FairMultiple issues that should be addressed
Below 50PoorSignificant deviations from brand voice

How scores are calculated

Brandlint evaluates each user-facing string against your guidelines, considering:

  1. Tone alignment — Does the copy match your brand's formality level?
  2. Word choice — Are you using preferred terminology?
  3. Clarity — Is the copy clear and actionable?
  4. Consistency — Does it match patterns elsewhere in your product?

The final score is a weighted average across all reviewed strings.

Improving scores

To raise your scores:

  • Review suggestions and apply recommended changes
  • Update your guidelines to match your actual voice
  • Adjust the threshold if it's set too aggressively

Scores over time

Track your team's brand consistency by watching average scores across PRs. Improving scores indicate better alignment with your guidelines.