Cleanup checks the pages you choose against today's code and the full history of your connected repos, and tells you which ones describe things you removed or never built. It never edits a page: you always decide what to do with its findings.
<aside> ✏ Cleanup is a credit-based add-on and only appears on workspaces where it's turned on. If you don't see Cleanup in the navigation, it isn't enabled for your workspace yet.
</aside>
You need at least one connected repo and one destination (a watched Notion page or GitHub docs folder) with pages mapped to it. If you haven't set these up yet, the cleanup screen links you to Go to Repos and Go to Pages to finish that first.
The cleanup begins running and appears in your cleanup list with a Progress indicator showing pages done against pages to do.
Cleanup can take some time for large repos or long histories.
Open a finished (or in-progress) cleanup to see its report. Each checked page gets one verdict:
| Verdict | What it means |
|---|---|
| Probably remove | The page describes something the cleanup could not find in the current code or its history. |
| Keep | The page's content still matches something in the repos checked. |
The report lists To do and Done counts as the run progresses, and you can filter the page list by verdict. Cleanup only ever reports; it does not change, comment on, or remove anything from the page itself. Acting on a "probably remove" verdict is up to you.
<aside> ✏ If a page's content doesn't match anything in the repos you selected, check that you chose the right repos for that page. A page mapped to the wrong repo will often come back as "probably remove" even when it's accurate.
</aside>
While a cleanup is running, you can control it from its detail page: