From 6cf7bb6f7a1e129a9c85f0d91246913f64127989 Mon Sep 17 00:00:00 2001
From: Nik Cubrilovic <git@nikcub.me>
Date: Fri, 12 Jun 2026 23:35:27 +1000
Subject: [PATCH] docs(cloud): document scheduled audits (Pro feature) + audit
 source labels

---
 cloud/index.mdx            |  3 +++
 cloud/scheduled-audits.mdx | 44 ++++++++++++++++++++++++++++++++++++++
 docs.json                  |  3 ++-
 3 files changed, 49 insertions(+), 1 deletion(-)
 create mode 100644 cloud/scheduled-audits.mdx

diff --git a/cloud/index.mdx b/cloud/index.mdx
index a23ede6..70dc586 100644
--- a/cloud/index.mdx
+++ b/cloud/index.mdx
@@ -45,6 +45,9 @@ You stay in control of spend with a per-audit credit cap and a confirmation prom
   <Card title="Browser Rendering" icon="globe" href="/cloud/rendering">
     Render JavaScript-heavy sites with a cloud headless browser
   </Card>
+  <Card title="Scheduled Audits" icon="calendar-clock" href="/cloud/scheduled-audits">
+    Re-audit your sites automatically on a daily, weekly, or monthly schedule
+  </Card>
   <Card title="Dashboard" icon="layout-dashboard" href="/dashboard">
     Published reports, issue tracking, and billing at app.squirrelscan.com
   </Card>
diff --git a/cloud/scheduled-audits.mdx b/cloud/scheduled-audits.mdx
new file mode 100644
index 0000000..c7fbc2d
--- /dev/null
+++ b/cloud/scheduled-audits.mdx
@@ -0,0 +1,44 @@
+---
+title: "Scheduled Audits"
+description: "Re-audit your sites automatically on a daily, weekly, or monthly schedule"
+icon: "calendar-clock"
+---
+
+Scheduled audits re-run a full cloud audit of a website on a fixed cadence - **daily, weekly, or monthly** - with no manual trigger. Each run lands in the [dashboard](/dashboard) alongside your on-demand audits, so you can track score changes and catch regressions over time.
+
+<Note>
+  Scheduled audits are a **Pro** feature. On the free plan the schedule is shown as an upgrade prompt; new free websites are not scheduled.
+</Note>
+
+## Setting a schedule
+
+Schedules are managed from the dashboard, per website:
+
+1. Open the website at `app.squirrelscan.com`.
+2. Use the **Scheduled Audits** card on the website overview (or go to **Settings → Schedule**).
+3. Pick a cadence - **Daily**, **Weekly**, **Monthly**, or **Disabled**.
+
+On a Pro plan, new websites default to a **weekly** schedule. You can change the cadence or turn scheduling off at any time.
+
+## How runs behave
+
+- Each scheduled run is a normal cloud audit and **spends [credits](/cloud/credits)** like any other cloud audit. Stay within budget with the same per-audit spend controls.
+- If an audit for the website is already running when the schedule fires, the scheduled run is skipped for that cycle.
+- Results, score deltas, new issues, and notifications appear in the dashboard automatically.
+
+## Audit source
+
+Every audit records where it was triggered from. In the dashboard, audits and reports are tagged with a **source** badge:
+
+- **CLI** - run from the `squirrel` command line
+- **Cloud** - run on demand from the dashboard
+- **Scheduled** - run automatically by a schedule
+- **GitHub** - run from a GitHub pull request or push
+
+This makes it easy to tell an automated weekly run apart from one you kicked off by hand.
+
+## Related
+
+- [Cloud overview](/cloud) - what cloud features add
+- [Credits & Pricing](/cloud/credits) - how scheduled runs are billed
+- [Dashboard](/dashboard) - where scheduled results live
diff --git a/docs.json b/docs.json
index 7ed8de7..e18b031 100644
--- a/docs.json
+++ b/docs.json
@@ -482,7 +482,8 @@
               "cloud/index",
               "cloud/credits",
               "cloud/rules",
-              "cloud/rendering"
+              "cloud/rendering",
+              "cloud/scheduled-audits"
             ]
           },
           {