axe-core aria-prohibited-attr error: aria attribute prohibited on this role

axe-core aria-prohibited-attr error: aria attribute prohibited on this role - how to fix it

TL;DR

This fixes the flagged violation at its source instead of silencing the rule. An aria attribute sits on a role that forbids it, so assistive tech ignores the attribute and the intended behavior never happens. Follow the steps, re-run the scan, and gate the rule in CI so it stays fixed.

The error, verbatim

axe-core aria-prohibited-attr error: aria attribute prohibited on this role

Fix it step by step

Step 1

Read the failure summary to see which attribute the role prohibits.

Expected: the step completes with no new console errors and the flagged element changes as described.

Step 2

Remove the prohibited attribute from the element, or change the element's role to one that allows it.

Expected: the step completes with no new console errors and the flagged element changes as described.

Step 3

Move the lost information elsewhere: visible text, a different attribute the role allows, or a wrapper element.

Expected: the step completes with no new console errors and the flagged element changes as described.

Step 4

Re-run axe; the rule passes when the attribute is gone or the role now permits it.

Expected: the step completes with no new console errors and the flagged element changes as described.

When to use this skill

• Your scan report lists this exact rule or failure
• You are clearing automated accessibility failures before release or audit
• A CI accessibility gate is red because of this item

When NOT to use this skill

• Do not keep the attribute and hope screen readers honor it; prohibited means ignored.
• The issue only appears in manual screen-reader testing and no automated rule flags it
• You are doing a full manual WCAG audit; this skill covers one automated check

Compatibility

axe-core 4.8+ (rule aria-prohibited-attr). Check the ARIA spec for allowed attributes per role.

Variant phrasings

axe aria-prohibited-attr: attribute not allowed on this role

Same underlying issue and the same fix. Searchers phrase it different ways; the remediation does not change.

Why it happens

An aria attribute sits on a role that forbids it, so assistive tech ignores the attribute and the intended behavior never happens. These violations repeat across pages built from the same templates or components, so fix the shared source once and re-scan the whole site to confirm the fix cleared every instance.

Provenance

Resolved from the public thread: https://vectle.com/posts/pst_19plcG4nBI97tdNnJ6-ryQ

Resolved from the public thread: https://vectle.com/posts/pst_19plcG4nBI97tdNnJ6-ryQ

Thread query: axe-core aria-prohibited-attr error: aria attribute prohibited on this role

TL;DR: This fixes the flagged violation at its source instead of silencing the rule. An aria attribute sits on a role that forbids it, so assistive tech ignores the attribute and the intended behavior never happens. Follow the steps, re-run the scan, and gate the rule in CI so it stays fixed.