Skip to content
TidyKB

When scans run and the weekly report

Set your workspace time zone, choose the day and hour of the weekly report, and see exactly when a full scan, a daily top-up and a manual scan run.

Updated

A knowledge base rots on a schedule, so TidyKB checks it on one. Everything about when things happen comes from three settings on the Scan schedule page: your time zone, the day of the week for the report, and the hour.

One setting drives everything

Pick a time zone from the full IANA list — Europe/Berlin, America/New_York. New workspaces start on UTC, and the page offers your browser's zone until you have chosen.

Then pick the weekday and hour your weekly report should land. Everything else is derived from that single time:

WhatWhen
Weekly reportYour chosen weekday and hour
Weekly full scanFour hours earlier, so the report describes a scan from that morning
Daily top-up (Pro)The same local time of day, every day

Times are wall-clock times in your zone, worked out from the calendar rather than by adding seven days to the last run. Across a daylight-saving change a weekly job is 167 or 169 hours apart, not 168, so adding a week would drift an hour a year and can fire twice in the week the clocks go back. A 07:00 report stays at 07:00.

The page prints the next scan and the next report as real dates and times, so you can check you set what you meant.

The weekly full scan

Every paid plan gets a full scan once a week: every category, folder and article, in every language your portal serves, followed by a link check and all eleven rules. It is the scan that produces the totals and the health score on your dashboard.

Why your scan starts at an odd minute

Each connection gets its own minute within the hour, derived from its id, so a thousand workspaces on the same schedule do not all call Freshdesk on the hour. Beyond that, TidyKB uses at most half your Freshdesk account's per-minute API budget across all of its jobs and leaves the rest to your agents and other apps.

The daily top-up on Pro

On Pro, TidyKB also runs a daily scan between the weekly ones. It re-reads only the articles Freshdesk reports as changed since the last scan and refreshes their findings, which is why it is cheap enough to run every day.

A top-up has no score of its own, and because it did not look at everything it never concludes that an article is gone — see what a scan refuses to claim. Any scan on a given day counts as that day's top-up, so the weekly full scan never costs you a daily one as well.

The weekly report

The report is the score, what broke since last week and what was fixed, in an email short enough to read on a phone and forward to a manager.

On the same settings page you can switch it off, and you can list up to ten addresses to send it to; leave the list empty and it goes to the members of your workspace. The scan that feeds it runs four hours before it, so the numbers are from that morning rather than from last week.

A trend between two scans is only shown when both measured the same set of checks. When they did not — a language appeared, or one scan was clipped by your plan's article limit — TidyKB shows a dash and one line saying why, rather than a difference that would not mean anything.

The email is not sending yet

The time zone, the schedule, the recipient list and the scans behind the report are live now. The weekly email itself is the last piece being finished before launch, so nothing lands in your inbox today. Scans still run on the schedule described here, and the health scan page always has the current numbers.

Scanning on demand

Scan now, on the health scan page, starts a full scan immediately. It counts as that day's run, so it costs you nothing extra.

When a scan does not run

The scheduler skips a workspace, rather than piling up work, when:

  • The plan has no private scan. The free plan includes the public audit only.
  • The connection is not working. A failed or untested connection is never scanned; fix it on the connection page.
  • A scan is already queued or running for that connection. Only one at a time, ever.
  • It is already up to date for this occurrence.
  • You asked too soon. A manual scan has a five-minute cooldown after the previous one.
  • It has already failed three times for the same due occurrence, an hour apart. The workspace then waits for the next occurrence instead of hammering a broken connection.

Freshdesk and Freddy are trademarks of Freshworks Inc. TidyKB is an independent product and is not affiliated with, endorsed or sponsored by any company named on this page.

FAQ

Questions, answered

Which time zone are the times in?

Your workspace’s own, picked from the full IANA list on the scan-schedule page; new workspaces start on UTC. Times are wall-clock times, so a 07:00 report stays at 07:00 across a daylight-saving change instead of drifting by an hour.

Why does my scan start at an odd minute?

Each connection gets its own minute within the hour, derived from its id, so that every workspace on the same schedule does not call Freshdesk at the same moment. Beyond that, TidyKB uses at most half of your Freshdesk account’s per-minute API budget and leaves the rest to your agents and other apps.

Can I scan more often than my plan’s schedule?

You can start a scan yourself at any time, with a five-minute cooldown after the previous one and never two at once. It is a full scan and it counts as that day’s run, so a manual scan never costs you an extra one.

See your help center’s score.

Paste a URL. No signup, no API key, no call.

Run free audit