Scheduled scans run automatically on a weekly or monthly basis, keeping your cookie inventory up to date without manual intervention. This is especially important for websites that frequently add new features, integrations, or marketing tools that may introduce new cookies.
Pro Feature: Scheduled scans require a Pro or higher plan. Free plan users can run manual scans only. Upgrade from the Account & Billing page.
Setting a Scan Schedule
Navigate to your site's Cookies & Scripts page and look for the Automatic Scanning section. Choose from three options:
- Off - no automatic scanning. You must trigger scans manually.
- Weekly - the scanner runs every 7 days.
- Monthly - the scanner runs every 30 days.
After selecting a frequency, click Save Schedule. The interval counts from your last scan, not from a fixed weekday or date: the last scheduled scan, or the last scan you ran yourself that completed, whichever is later. The section shows the date of the next scan.
How Scheduled Scans Work
Kukie.io runs a daily background command at 03:00 UTC that checks every site with a scan schedule. For each site where a scan is due, the system:
- Confirms that the site's organisation has an active subscription on a plan that includes scheduled scans.
- Checks whether enough time has passed since the last scan (7 days for weekly, 30 days for monthly). A scan you ran yourself counts once it has completed.
- Dispatches a scan job if both conditions are met.
Scheduled scans use the same scanning engine as manual scans. They follow the same URL discovery process, page limits, and auto-categorisation pipeline. The only difference is the scan_type field, which is recorded as scheduled instead of manual in your scan history.
Tip: Scheduled scans run at 03:00 UTC to minimise impact on your website's traffic. If your site has low traffic at a different time, you can still rely on the rate limiter to keep the scan gentle.
Plan Requirements
Scheduled scans are gated by the has_scheduled_scans flag on your plan. The scan schedule UI is visible on all plans, but only paid plans with this feature enabled can save a non-"None" schedule. If you try to set a schedule on a plan that does not support it, you will see an upgrade prompt.
If you downgrade to a plan without scheduled scans, your schedule setting is preserved but scans will no longer be triggered automatically. Upgrading again re-activates the existing schedule without requiring reconfiguration.
Notifications After Completion
When a scheduled scan completes, you receive a notification (email or in-app, depending on your notification preferences) with a summary:
- Scan status (Completed / Completed with errors).
- Number of pages scanned.
- Total cookies found.
- New cookies discovered since the previous scan.
- Number of uncategorised cookies (if any).
If the scan finds uncategorised cookies, the notification includes a link to the Cookies & Scripts page where you can review and categorise them immediately.
Monitoring Scheduled Scans
You can track the history of all scheduled scans in the Scan History tab on the Cookies & Scripts page. Each entry shows whether the scan was manual or scheduled, along with the standard result summary.
If a scheduled scan fails (for example, because your site was temporarily unavailable), it will be retried at the next scheduled interval. Failed scans do not trigger additional retries between intervals.
Best Practices
- Weekly is recommended for sites that frequently update content or add new marketing tools.
- Monthly is sufficient for stable sites with infrequent changes.
- Always review uncategorised cookies after a scheduled scan to keep your consent banner accurate.
- Combine scheduled scans with the known cookie database for the highest auto-categorisation accuracy.
