Accessibility score calculation
The formula for calculating the App Accessibility score.
The accessibility score of a report is calculated based on the number of rules violated in the report and the severity of those violations.
Calculating accessibility score
BrowserStack App Accessibility Testing calculates the accessibility score of your report in the following steps:
Based on whether an accessibility rule is applicable, passed, or failed, a multiplier is assigned as follows:
| Multiplier | Condition | Description |
|---|---|---|
| 1 | Passed | The rule is applicable to at least one element in the report. All elements assessed against the rule passed. |
| 2 | Failed | The rule is applicable to at least one element in the report. At least one element assessed against the rule has a confirmed violation. Failed rules have a higher multiplier, as failures are penalized more than passes are rewarded. |
| 0 | Not applicable | The rule does not apply to any element in the report. |
A rule is considered:
- Applicable when the rule is selected for the report and at least one element in the report is assessed against it.
- Passed when no element assessed against the rule has failed.
- Failed when at least one element assessed against the rule has a confirmed violation.
Experimental rules are included in the score calculation.
Based on the severity of each accessibility rule, a score is assigned as follows:
| Score | Severity |
|---|---|
| 10 | Critical |
| 7 | Serious |
| 3 | Moderate |
| 1 | Minor |
The total passed score (P) and failed score (F) are calculated using the following formulae:
For each applicable rule i from 1 to r,
Impact of passed rules on score = P = Σ(Severityi × Applicablei × Multiplieri)
Impact of failed rules on score = F = Σ(Severityi × Applicablei × Multiplieri)
With a multiplier of 2 applied to failed rules, failures are penalized twice. The effective score values are:
Minor: 2, Moderate: 6, Serious: 14, Critical: 20
The accessibility score for a report is calculated using the following formula:
Accessibility score = [P / (P + F)] × 100
Where:
- A score of 100 means all applicable rules passed.
- A score of 0 means all applicable rules failed.
- If no rules are applicable to the report (P + F = 0), the score is not calculated.
Needs Review issues are not treated as failed. They are treated as passed until you review and confirm them as valid accessibility violations. Confirming a Needs Review issue updates the accessibility score to reflect the change.
Frequently asked questions
Why did my accessibility score change between two scans of the same app?
The score of a report reflects the screens captured in that scan, the rules selected, and the rule-engine version the scan ran on. A score change between two scans can come from any of the following:
- App changes: New failures, fixed failures, or shifts in rule applicability from changed screens.
- Scan configuration: A different rule selection, or a different set of flows scanned.
- Rule-engine updates: New, updated, or refined accessibility rules from BrowserStack that can shift the score even when your app hasn’t changed.
Is the score calculated the same way for Manual Tests and Automated Tests reports?
Yes. The same formula, severity weights, and multipliers apply to both Manual and Automated App Accessibility test reports.
How is rule applicability determined for a report?
A rule is applicable to a report when both of the following are true:
- You’ve selected the rule to run as part of the scan configuration.
- At least one element in the report is in consideration for the rule. For example, the Touch target size and spacing rule assesses interactive elements in the UI. Therefore, this rule is applicable if there is even a single interactive element in the app.
What happens to the score when I hide an issue?
Regardless of whether you hide the issue, the score depends on the total number of rules failed or passed. The impact is as follows:
- There is no impact on the score if the hidden issue was a failure and at least one other failure exists for the same rule in the report.
- The score increases if the hidden issue is the only failure for the rule and the rule has at least one passing case. In this scenario, the rule is considered as passed.
- The score increases if the hidden issue is the only failure for the rule, and the rule has no passing cases. In this scenario, the rule is considered as not applicable.
- There is no impact on the score if the hidden issue is a Needs Review case that requires your assessment.
- If you review and confirm the Needs Review issues, they are treated as failures. Depending on whether other failures exist for the same rule, the score either stays the same or increases when you hide such issues.
What happens to the score when I un-hide an issue?
The impact depends on the original state of the issue and whether other un-hidden issues exist for the same rule:
- There is no impact on the score if the un-hidden issue is a Needs Review case that requires your assessment.
- There is no impact on the score if the un-hidden issue was a confirmed case and at least one other un-hidden issue exists for the same rule in the report.
- The score decreases if the un-hidden issue was a confirmed case and no other un-hidden issue exists for the same rule. In this scenario, the rule is considered as failed.
- If you review and confirm the Needs Review issues, they are treated as failures. Depending on whether other failures exist for the same rule, the score either stays the same or decreases when you un-hide such issues.
What happens to the score when I assess a Needs Review issue?
Needs Review issues are not treated as failed. They are treated as passed until you review and confirm them as valid accessibility violations. Based on your review, the score can change as follows:
- If you confirm a Needs Review issue as a violation, it is treated as a rule failure. Depending on whether other failures exist for the same rule, the score either stays the same or decreases.
- If you undo a confirmation, the issue reverts to a Needs Review issue and the score is re-adjusted to reflect the change.
- Marking a Needs Review issue as a non-issue doesn’t affect the score.
Why doesn't my report show an accessibility score?
The accessibility score isn’t calculated in the following scenarios:
- The scan is still in progress.
- The scan completed but no screens were captured.
- No accessibility rules are applicable to any of the captured screens.
- The score calculation service encountered an error after the scan completed. The report is still viewable. You can try running the scan again or contact BrowserStack Support.
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.
We're continuously improving our docs. We'd love to know what you liked
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.
We're continuously improving our docs. We'd love to know what you liked
Thank you for your valuable feedback!