Auto Schedules
Sitemap schedules
One schedule that captures every page of a sitemap. The sitemap is read again at every run, so pages added to the site are picked up and removed ones stop being captured, without editing anything.
What a sitemap schedule is
An ordinary schedule captures one address. A sitemap schedule points at a sitemap instead — often https://example.com/sitemap.xml — and at each run captures the pages it lists, with one Web Profile and one cadence for all of them.
A page schedule takes at most 10 addresses in one go, each becoming a schedule of its own. To get a sitemap's addresses as a list instead, use Extract URLs.
Creating one
- 1
Choose Sitemap
In the new schedule form, the first choice is Pages or Sitemap. Choose Sitemap. Without a plan that includes it, the choice is locked and marked Pro. - 2
Enter the sitemap address
An XML sitemap, a sitemap index, or a text file of URLs. Only pages on the sitemap’s own site are captured. - 3
Narrow it down, if you want
Fill in Only pages matching, Leave out pages matching and Pages per run. All three are optional. - 4
Preview the pages
Reads the sitemap now with these settings — the same decision every run makes — and shows how many pages will be captured each run, about how many a month at the chosen frequency and how that compares with your quota, and the pages the run takes. - 5
Finish the rest of the form
Choose the Web Profile and when it runs, as for any schedule, and save. The Web Profile’s location must be one with dedicated proxies — the form lists them — and the schedule runs at most once a day.
The kind is fixed
Choosing the pages
| Value | Meaning |
|---|---|
Only pages matching | One pattern per line. When there are any, only pages that match at least one are captured. |
Leave out pages matching | One pattern per line. Checked after the patterns above. |
Pages per run | The most pages one run captures, up to your plan’s limit of 1,000. Empty uses the plan’s limit. When more pages match, they take turns: each run takes the pages captured least recently, never-captured ones first, so every page comes round. |
A pattern is matched against the page’s path and query, ignoring case, and * stands for anything:
| Value | Meaning |
|---|---|
/blog/* | Every page under /blog/. |
*/print | Every page whose path ends in /print. |
/products/* | Every page under /products/. |
- Every pattern starts with / or *.
- At most 20 patterns in each box, and at most 200 characters each.
What happens at each run
- The sitemap is read again.
- Pages on other sites are dropped. The sitemap’s own site includes its subdomains, and
www.makes no difference. - Only pages matching is applied, then Leave out pages matching.
- Up to Pages per run are taken, least recently captured first. With 2,400 matching pages at 1,000 a run, each page is captured every 3 runs; the preview and each run say so.
- The pages are requested one after another, spaced to the capacity of the location’s dedicated proxies and never faster than your plan’s rate limit. With three proxies that is about one page every 10 seconds, so 1,000 pages take about 2¾ hours.
A failing site stops the run
A run that would overlap is skipped
A sitemap schedule runs on its schedule only: Quick Capture and the Auto Schedule API’s trigger are not available for it. To run one now, create it with Start set to Immediately.
The Sitemap runs list
A sitemap schedule’s page has a Sitemap runs panel, with one row per run: when it ran, that the schedule started it, and what happened.
| Value | Meaning |
|---|---|
Capturing N pages | The run is working through its pages. |
X of Y pages captured | The run has finished. Pages that failed are the difference. |
Missed | The run was due but did not take place. |
Stopped early | More than half of the first 20 finished pages failed, so the run stopped. The pages not tried were not charged. |
Nothing captured | The run captured no page. The row says why — the sitemap could not be read, no page matched, the sitemap listed none, the previous run was still capturing, the Web Profile’s location has no dedicated proxies, the plan does not include sitemap schedules, or there was no active subscription. |
The pages themselves appear among the schedule’s captures like any other, each under its own address.
Extract URLs
Extract URLs, on the Auto Schedules page, reads a sitemap and downloads its pages as a CSV of address and last-modified date. It creates nothing, and it is available on every plan, the free trial included. It says how many pages the sitemap lists and which child sitemaps could not be read.
One sitemap every two minutes per workspace, because each one makes us fetch the site’s files. A mistyped address or a file that is not a sitemap can be tried again at once.
How it is counted
- The schedule counts as one schedule towards your plan’s limit, however many pages it has.
- Every page captured is one capture from your quota.
- If the quota or the storage runs out partway through, the run stops at that page and says so. The pages after it are not captured in that run.
- A run that stops early because the site is failing gives back the pages it did not try.
Check the monthly figure before you save
How it differs from a page schedule
| Value | Meaning |
|---|---|
No capture emails | The pages of a sitemap run are never emailed one by one, whatever the profile says. Change emails are not sent for them either. |
Hide elements only | Hide these elements applies to every page of the sitemap. Selectors to capture, click or hover one element cannot be set on a sitemap schedule. |
Change detection per page | With change detection on the profile, each page is compared with its own previous capture. |
One folder per run | In Google Drive, Dropbox or an S3 bucket, the pages of one run go into a folder of their own, named by the run’s time, each file named by its page path. |
A webhook when the run ends | sitemap_run.completed is sent once every page of the run has finished, or 12 hours after the last page was due, with unfinished pages counted as failed. A run that queued nothing is announced at once, as failed, with the reason; a missed run sends none. See Webhooks. |
Which sitemaps can be read
- An XML sitemap listing pages.
- A sitemap index, one level deep: up to 50 child sitemaps on the same site are read. The preview says how many were read.
- A plain text file with one URL per line.
- Any of these compressed with gzip.
Up to 50,000 addresses in all, and 20 MB per file, are read. When a sitemap is larger, runs use its first part, and the preview says so.
Plans
| Value | Meaning |
|---|---|
Pro | Up to 1,000 pages per run. |
Business | Up to 1,000 pages per run. |
Business Plus | Up to 1,000 pages per run. |
Enterprise | Up to 2,000 pages per run, and more frequent runs, by arrangement. |
Starter and the free trial | Not included. Extract URLs is. |
- A sitemap schedule runs at most once a day, on every plan.
- Its Web Profile’s location must have dedicated proxies; the form and the error name the current ones. A schedule whose profile is later moved elsewhere fails its runs, charging nothing, until it is moved back.
Did this page answer your question?
Tell us what is missing