# Broken Link Checker for Your Site and Docs

Source: https://maito.app/workflows/check-for-broken-links-and-pages

Every week Maito crawls your site or docs, finds broken links, missing images and errors, and posts them with the page each one is on.

Crawl your site and docs for broken links, missing images and errors.

[QA](https://maito.app/workflows/team/qa) · [Software](https://maito.app/workflows/industry/software) · On a schedule · Updated October 19, 2026

Works with

-   Slack
-   Email

## How do you check a site for broken links and pages?

To check a site for broken links and pages, set a Loop in Maito for a weekly crawl. It visits every page of your site or docs, tests each link and image, and posts the broken ones in Slack with the page they are on. It also marks problems on high-traffic pages first.

## How it's done today

Broken links pile up quietly.

## What Maito does

1.  Crawl the site
2.  Check every link and image
3.  Report problems with where they are

## Example

Loop run: Monday 8:00 AM · Docs link check

**Maito** (8:07 AM):

Crawled 412 pages, 3,860 links and 96 images on docs.northstar.example. 6 broken links on 4 pages, 1 missing image.

• /guides/webhooks: 2 links to /api/v1/events return 404  
• /guides/sso: the link to Okta's old setup page is gone (410)  
• /changelog/2026-09: 2 links to deleted blog drafts  
• /quickstart: 1 link goes into a redirect loop  
• /guides/export: export-step3.png is missing

**Catch:** /quickstart is linked from the signup page, so every new user who reaches step 3 hits the loop.

Found by crawling the live site.

**Alex** (8:30 AM):

what should the events links point to?

**Maito** (8:32 AM):

/api/events. It returns 200 and has the same section heading. For SSO I'd remove the link, because the old Okta page is gone. Want me to draft the edits?

## How to set it up

On a schedule Check for broken links and pages

Ask your agent

“Every Monday at 8, crawl docs.northstar.example and check every link and image. Post the broken ones, with the page they're on, in #docs.”

## What it won't do

It finds links that fail when it visits. A link that works but points to the wrong page is not something it can tell.

## Questions

### How often does it crawl?

On the schedule you set, such as every Monday morning. You can also ask for a crawl at any time.

### Does it fix the links?

It reports them. It can open a pull request for links in your docs repository if you ask.

### Can it crawl pages that need a login?

Yes, with a login stored in the Vault. Public pages need nothing.

## More qa workflows

-   [Test a branch in a real browser before merge Every change gets clicked through in a real browser, with a video. QA · When something happens Works with Slack, Email.](https://maito.app/workflows/test-a-branch-in-a-real-browser-before-merge)
-   [Nightly regression run Your key flows get tested every night, with a report in the morning. QA · On a schedule Works with Slack, Email.](https://maito.app/workflows/nightly-regression-run)
-   [Reproduce a reported bug against the last release Check whether a bug is new, old, or already fixed. QA · When you ask Works with Slack, Email.](https://maito.app/workflows/reproduce-a-reported-bug-against-the-last-release)
-   [Write test cases from a spec Turn a feature spec into a checklist of test cases, including edge cases. QA · When you ask Works with Box.](https://maito.app/workflows/write-test-cases-from-a-spec)
-   [Check the site on many screen sizes See how key pages look on phones, tablets and wide screens. QA · When you ask Works with Slack, Email.](https://maito.app/workflows/check-the-site-on-many-screen-sizes)

[See all workflows](https://maito.app/workflows)

## Put your AI teammate to work.

Set it up in minutes. Start with this one, and let it earn the next one.

[Put Maito to work](https://maito.app/login?returnTo=%2Fworkflows%2Fcheck-for-broken-links-and-pages)[Book a demo](mailto:support@maito.app?subject=Maito%20demo)
