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.

Scores Explained - Brandlint