axe Configuration

Link to axe Configuration copied to clipboard

In order to create consistent settings across your whole organization for multiple Deque products, axe Configuration allows users and admins to control all of their settings in one place! For admins, setting organization-wide defaults and even locking specific settings down to specific values is possible. For all users, configuring these settings in 1 place allows for consistency across products, platforms, browsers, and devices.


axe Configuration is currently only supported by the axe DevTools Extension and axe Developer Hub. Other Deque products are working on adding support for axe Configuration in the future. Read more about how configuration changes will be reflected in these products.


This feature is not currently available to private cloud / on-prem instances. Support for this in these environments will be added in a future release.

How It Works

The axe Configuration page can be found on Once there, users will be presented with a "Global" configuration panel as well as links to configure other Deque products they have access to.

Enterprise admins, enterprise users, as well as individual license holders have access to axe Configuration. The capabilities of each user type slightly varies. These differences are described below.


For settings that are set in both axe Configuration and configured via policy, the value set in axe Configuration will be used instead of the policy's value.

Enterprise Admins

Screenshot of axe Configuration admin page with "Global" configuration selected

Admin settings are broken down into 2 main use cases:

  • setting specific defaults
  • "locking" specific settings down and preventing users in your organization from changing them

Setting Defaults

When an admin sets a default value for a setting, users in their enterprise can expect to see their settings reflect that default. However, if users choose to do so, they may override the default unless the admin has explicitly chosen to prevent users from changing the given setting (see below).

Allowing Users to Change Settings

By default, all axe Configuration settings can be changed by users in the enterprise. However, if an admin chooses to, they may uncheck the "Allow users to change" checkbox which will prevent any users from overriding the chosen default value.

Enterprise Users

Screenshot of axe Configuration non-admin page with "These settings are managed by your admin" notification banner

Enterprise users can view the settings configured by their admin. However, they will not have the ability to change any settings. They will be informed of this with a non-dismissible banner reading "These settings are managed by your admin".

Individual License Holders

Screenshot of axe Configuration page for individual license holders with "Global" configuration selected

Individual license holders can set their own default values. Unlike enterprise admins, they will not be presented with "Allow users to change" controls.

Available Global Settings

Name Description Default Value
Default Accessibility Standard The accessibility testing standard to be used (WCAG/Trusted Tester standards are available) WCAG 2.1 AA
Default Axe Core Version The version of axe-core to be used for automated scans Latest
Default Needs Review How incomplete / "needs review" issues should be handled (can be disabled, enabled but excluded from issue totals, or enabled and included in issue totals) Disabled
Default Best Practices Whether or not best practices should be disabled Disable
Default Experimental Rules Whether or not experimental rules should be disabled Disable
Default Shared Issue Screenshots Whether or not issue screenshots should be captured in products that support them Enable
Default Machine Learning Whether or not Machine Learning (ML) enhancements should be turned on Enable
Usage Service Whether or not usage data will be tracked in the provided Usage Service "URL" Enable
Usage Service "URL" The URL of the server where usage data is sent
Usage Service "Organization" The name of your organization to be added as metadata to your usage analytics
Usage Service "Department" The name of your department to be added as metadata to your usage analytics
Usage Service "Application" The name of your application to be added as metadata to your usage analytics

Product-specific Configuration

How Will Configuration Changes be Reflected in Deque Products?

Once a change is made in axe Configuration, each product has their own ways of incorporating those changes. Currently, only the axe DevTools Extension and axe Developer Hub support axe Configuration; however, all Deque products will eventually support it.


axe DevTools Browser Extension v4.62 and greater support axe Configuration. If you are on an older version you must upgrade to unlock this functionality.

axe DevTools Extension

For the axe DevTools Extension, changes in axe Configuration will be reflected the next time the user opens the extension, logs in, or navigates to the settings page within the extension.


To force the configuration changes to appear, instruct your users to open a new instance of the extension. If they already have it open they can simply close and reopen it.


Due to the "offline" nature of the Offline Mode feature, the only way to control settings across a whole organization is using configuration via policy.

axe Developer Hub

For axe Developer Hub, changes in axe Configuration will take effect on any future test runs and will be reflected in the reports. Any previous test runs and reports will not be impacted by axe Configuration changes; however, a notice will appear on the pre-existing reports, calling out that a change has occurred since this report was created.