Skip to main content

This content has been archived and is no longer being updated. Links may not function; however, this content may be relevant to outdated versions of the product.

Support Article

Accessibility testing - Ensures landmarks are unique



During Accessibility testing with the Axe tool, the 'Landmarks should be unique' error message displays in the Axe console.

Error Messages

From the Axe console:


Landmark-unique is a new best practice rule ensures that landmarks have a unique role or accessible name (i.e. role, label, title) combination.
Severity Medium
Required Correction

Landmarks must have a unique role or role/label/title (i.e. accessible name) combination

Element location


Element source

<header id="l1" class="screen-layout-region screen-layout-region-header not-nav" aria-label="Top Panel" role="banner">

To solve this violation, you need to:

Fix the following:

The landmark must have a unique aria-label, aria-labelledby, or title to make landmarks distinguishable

Related node:

#PegaGadget1Ifr header

Steps to Reproduce

  1. Log in as a user.
  2. Create any case.
  3. Run the Accessibility test on the screen (use any tool or Chrome extension such as 'Axe'). Error displays.

Root Cause

The field value was the same for both the portal and the work area harness. Hence the same label was set for all aria-labels.


Perform the following local-change:

The aria-label used for screen layout various regions relies on their respective field values.

For example, to set the aria-label in the top panel, refer to the 'Top Panel' field value. Refer to the 'Left Panel' to set the aria label of the left panel and so on.

To set a unique value for aria-labels perform the following steps,
  1. Save As the field values.
  2. Add property references (for example, Top Panel for {.pyLabel}).
  3. Set the pyLabel accordingly on the primary page.
If the property is not set, it is set to the remaining string provided in the 'To' field of the localized label in the field value.

Published February 12, 2020 - Updated December 2, 2021

Was this useful?

0% found this useful

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega Community has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice
Contact us