Ally for Websites crawler

The Ally for Websites crawler incorporates the Disallow statements in a website’s robots.txt file. These statements help prevent the crawler from getting stuck in infinite crawling loops on specific types of content such as search pages, calendar applications, and so on.

The Ally for Websites crawler adheres to the Robots exclusion standard. The specific user agent Ally uses is: blackboardally

Disable alternative formats

You can turn off alternative formats for individual content items, if you want. Add the data-ally-af-disabled attribute to the linked file in your HTML. This attribute keeps the file from appearing in the Alternative formats panel.

For example, if you add it to a linked file, that linked file won't appear in the list:  <a data-ally-af-disabled href:"https://filename.pdf">PDF file</a>.

Remove the attribute any time, if you want the content item to appear in the Alternative formats panel.


<!doctype html>
<html lang="en">
    <p><a href="/example1.pdf">This link will show up</a></p>
    <p><a data-ally-af-disabled href="/example2.pdf">This link will not show up</a></p>

Exclude parts of a web page

You can exclude specific parts of a web page from the alternative format content. Add the data-ally-exclude attribute to the content element in your HTML. This attribute keeps the content from appearing in the alternative format selected.

For example, if you add the attribute to an image on the page, that image won't appear in the BeeLine Reader alternative format when you open it.

If there is a <main> element on the website, only what is inside that main element appears in the alternative format content. Anything outside of the main element is automatically excluded. You can still use the data-ally-exclude attribute exclude elements inside that main element.


<!doctype html>
<html lang="en">
    <p>This will show up</p>
    <p data-ally-exclude>This will not show up</p>

Configure alternative formats download icon

Decide how you want the alternative formats download icon to look. Choose one of these options:

  • Small icon on the left of the page: data-ally-af-style="flag_small"
  • Large icon on the left of the page: data-ally-af-style="flag_large"
  • Bar along the bottom of the page: data-ally-af-style="bar_bottom"

Use this script to customize the look and feel.

    Ally Website Integration Script.
    "data-ally-af-style" can be one of the following values to customize the look and feel:
        - flag_small
        - flag_large
        - bar_bottom

Configure content editor feedback

Configure your site to see exactly where your accessibility issues are. After you configure pages on your site, go to your accessibility report and find a domain with an issue. Select the score indicator on the item with the accessibility issue to open the editor content feedback panel. See the issues highlighted on your page in the preview window.

Pages on your site need to have these settings, if you want your page content to appear in the preview window.

  • Support HTTPS
  • Add the AllyJS script

    This script is also required for alternative formats. If you want to see the issues highlighted in the preview window, but don't want to add the alternative formats to your site, use the data-ally-af-style=none property.

  • Allow the page to be embedded in an iframe by the Ally domain
  • Allow scripts, styles, images, and child iframes hosted by the Ally domain


Allow Ally to embed your pages in an iframe

If you want to take full advantage of the content editor feedback panel, as a trusted partner, Ally needs permission to embed your content in an iframe. This permission allows Ally to show your content in the preview window of the content editor feedback panel. The panel can only be accessed from your Accessibility report.

If you restrict your webpage from being embedded in iframes (for example, with the X-Frame-Options or Content-Security-Policy headers), you'll need to add or change your Content-Security-Policy header to add https://* to the frame-ancestors directive.


Examples of configuration
Current configuration Add or update frame-ancestors directive
X-Frame-Options header with value DENY Content-Security-Policy: frame-ancestors https://*;
X-Frame-Options header with value SAMEORIGIN Content-Security-Policy: frame-ancestors 'self' https://*;
Content-Security-Policy with a frame-ancestors directive of 'none' Content-Security-Policy: frame-ancestors https://*;
Content-Security-Policy with a frame-ancestors directive with a list of domains Content-Security-Policy: frame-ancestors 'self' https://* https://*;