Skip to main content
Many sites publish documents as well as pages: annual reports, forms, menus, meeting minutes. People who use screen readers and other assistive technology need those files to work too. Ility finds the documents your site links to and lists them next to its pages, so you can see what’s published and where. A surface’s documents appear after its next crawl.

How Ility finds documents

When Ility crawls a surface, it records every link to a document it finds on your pages. It recognizes these formats: Ility recognizes a document by the end of its URL. A link with no file extension, such as /download?id=42, is recognized when the server answers with a document file type. Documents follow the same rules as pages:
  • Ility follows your site’s robots.txt. See About IlityBot.
  • Ility only lists documents on the surface’s own site. A file hosted somewhere else, such as a file-sharing service, isn’t listed.
  • Documents count toward a crawl’s page limit, the same as pages.

See a surface’s documents

Open a surface and choose Documents in the sidebar. Documents aren’t listed in Crawled URLs, which shows web pages only. For each document, the list shows:
  • File: the file name.
  • Format: PDF, Word, PowerPoint, or Excel, or one of the older formats, such as Word 97–2003.
  • Linked from: how many of your pages link to it.
  • Status: what Ility can tell you about it. See Statuses.
Use the format filter, which starts at All formats, to show one format at a time. Choose a file name to see the document’s details. Its page shows the file’s full address, the advice for its format, and every page that links to it, with the text of each link. Use that list to decide what to do with the file: fix it, replace it with a web page, or remove the links to it.

Statuses

Ility doesn’t test Word, PowerPoint, or Excel files itself. Those apps have their own accessibility checker, which knows the file format best.

PDF testing

Ility doesn’t test PDFs yet. Every PDF shows Not tested yet, and scans don’t open PDFs. Testing PDFs against PDF/UA-1, the accessibility standard for PDF files, is in progress.