> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ilitylabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Run a scan

> Start, pause, and cancel scans, and see what changed between them.

A scan loads each page of a surface in a real browser on Ility's servers and runs automated accessibility checks against it. Members and owners can start scans. Viewers can watch them.

## Start a scan

There are several ways to start a scan, depending on what you want to check.

| To scan | Do this |
| - | - |
| Every active page on a surface | Open the surface and choose **Run scan** at the top right. |
| Only pages that have never been scanned | On the surface's **Overview**, choose **Scan N unscanned pages** in the **Automated coverage** card. |
| One page, or a handful | In **Crawled URLs**, choose **Rescan** on a page, or select pages and rescan them together. |
| Only the pages where one issue appears | Open the issue and choose **Re-check**. See [Working with issues](https://docs.ilitylabs.com/issues/working-with-issues.md). |

Scans use the surface's [settings](https://docs.ilitylabs.com/surfaces/surface-settings.md): its WCAG target and its enabled engines. Excluded pages are skipped.

If scheduled scanning is turned on for a surface, Ility also scans it automatically once a week.

> [!NOTE]
>
> A surface can only have one surface-wide scan running at a time. If you choose **Run scan** while one is in progress, Ility tells you and leaves the running scan alone. Rescanning a page or re-checking an issue can run alongside it.

## Follow progress

While a scan runs, the surface header shows how many pages are done. Results appear as each page finishes, so you don't have to wait for the whole scan.

* **Scans** in the sidebar lists every scan in the workspace, newest first. Filter it by status, and open a scan to see each page's result.
* **Activity** shows scans and crawls as they happen across all your surfaces.

A scan moves through these statuses:

| Status | Meaning |
| - | - |
| Queued | Waiting for a free slot on the scanner. |
| Running | Pages are being scanned. |
| Paused | Stopped by someone on your team. It keeps its place and can be resumed. |
| Complete | Every page has a result. Some pages may still have failed (see below). |
| Failed | The scan as a whole couldn't finish. If a [scan login](https://docs.ilitylabs.com/surfaces/scan-behind-a-login.md) can't sign in, the error starts with `Sign-in failed:`. |
| Canceled | Stopped by someone on your team. Pages already scanned keep their results. |

## Pause, resume, or cancel

While a scan runs, the surface header shows **Pause scan** and **Cancel** in place of **Run scan**. A paused scan shows **Resume scan**. Cancel asks you to confirm first.

## When a page fails

Sometimes a single page can't be scanned. The scan carries on with the other pages and records why that page failed. Common reasons:

| Reason | What it means |
| - | - |
| Rate limited | The site refused repeated requests (HTTP 429 or 503) through every retry. Scanning fewer pages at once usually clears it. |
| HTTP error | The page returned an error status, so there was nothing to scan. |
| Redirects off-site | The URL redirects to a different site. Update the link or exclude the page. |
| Blocked address | The URL resolved to a private or internal address. Ility only scans publicly reachable sites. |
| Signed out | The page sent Ility to the login screen, even after it signed in again. Check that the [scan login](https://docs.ilitylabs.com/surfaces/scan-behind-a-login.md)'s account can see this page. |
| Sign-out link skipped | The URL looks like a sign-out link, so Ility didn't open it. Opening it would end the login for every page after it. |
| Navigation timed out | The page didn't finish loading in time. |
| Page took too long | Scanning the page went over its overall time limit. |
| Could not reach the page | The browser couldn't connect to the page. |

> [!TIP]
>
> If your site blocks unfamiliar traffic with a firewall or bot protection, pages may fail with rate limiting or HTTP errors. Allow Ility's crawler through. See [About IlityBot](https://docs.ilitylabs.com/scans/ilitybot.md).

## Compare two scans

On a surface's **Overview**, choose **Compare scans** in the scan history to see what changed between two scans. Issues are sorted into three columns:

* **Disappeared**: found in the earlier scan and not in the later one.
* **Persisted**: found in both.
* **Appeared**: new in the later scan.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.