Posted on

Scanner Settings

Summary: The Scanner Settings will allow you to modify and save your accessibility scanner’s Viewport Width, Evaluation Delay, and your Scan Rate Limit.


Access Scan Settings

To access these settings:

  1. Select the Websites menu from the main menu
  2. Choose a website from your list of websites and select the actions button for that website
    Action Button Example
  3. Under the Website Settings widget, locate and select Scanner Options

Viewport Width (in pixels)

The Viewport Width setting will allow you modify the viewport size of the Pope Tech Accessibility Scanner.

Websites will often change how they are presented to the user depending on the user’s device and viewport size. Because viewport sizes change going from device to device (desktop, tablet, mobile), the accessibility of the website may also change.

It can sometimes be beneficial to test a website for each of the website’s configured viewport sizes, especially when different content is shown at different sizes. For most responsive websites you can test a few of the pages on mobile or tablet sizes and all of the pages on desktop (or vice versa if most of your users are using mobile).

Pope Tech Tip

In your dashboard you can set up separate websites with the same domain. Utilizing this feature you are able to change the scanner’s viewport settings on each so that you can schedule regular scans of your website using different viewport widths.

Evaluation Delay (in milliseconds)

Some web sites (or pages within the website) may take longer than normal to fully load JavaScript content. The most common scenario is Single Page Appplications (SPAs), where a lot of content is loaded after the pages loads. Increasing the Evaluation Delay will allow more time for a web page to completely load before its contents are scanned.

The default Evaluation Delay is 1000 milliseconds (1 second). This means the scanner waits 1 second after the page loads to evaluate the content. This can be increased or decreased depending on the website’s needs and capabilities. Evaluation Delay must be between 0 and 30,000 milliseconds (0 and 30 seconds).

Scan Rate Limit

The Scan Rate Limit will alter the speed (how many pages per minute) the website will be scanned at. The default Scan Rate Limit is 60 pages per minute. This can be sped up or slowed down depending on the needs and capabilities of the website being scanned.

Scan Rate Limit Example Settings

Add Blocked Host

The Blocked host Scanner Option allows you to block a specific host widget or a set of widgets from a single or similar host. For example you could block “” to not load the Google Map content for your scan.

You may also add a partial match as a blocked host entry. Partial matches will apply to any and all hosts that includes the partial match. Use caution when adding partial matches as they may have unintended consequences such as removing jQuery or other hosted libraries that may impact your accessibility scans accuracy. Any external loaded script with the content of the blocked host won’t load for the scan.

Keep in mind that the accessibility of 3rd party widgets should still be considered and is important for your users – but sometimes it is helpful to remove those from your scan to focus on things you can more easily control.

At the bottom of the Scanner Options when editing a website activate the “Add Blocked Host” button to add a blocked host.

Once the Blocked Host entry has been saved, future scans will not load the matching host(s) when the web page is rendered pre-evaluation.

Scan Errors/Timeouts

For websites that are receiving any time-out errors during accessibility scans, it is recommended that you slow down the Scan Rate Limit settings until the time-out errors are no longer present. For more information review How to Resolve Scanner Timeouts article.