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, Business, 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 Scan Schedule section. Choose from three options:
- None - no automatic scanning. You must trigger scans manually.
- Weekly - the scanner runs once every seven days.
- Monthly - the scanner runs once every thirty days.
After selecting a frequency, click Save Schedule. The next scheduled scan time is calculated from the current date and displayed below the dropdown.
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).
- 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.