Spardocs

Crawl

Help Spar reach and read your pages during audits with a site password, pinned URLs, and crawl scripts.

Most sites never need to touch Settings > Crawl. Use it when a password blocks Spar, when the audit keeps picking the wrong page for a page type, or when a page needs a click or two before it looks right.

Crawl settings page with the Site password, Pinned page URLs, and Crawl scripts cards
Crawl settings.

Site password

If your storefront is password-protected or you're auditing a staging site, enter the password here and click Save changes. Spar uses it when crawling and when showing page previews.

Pinned page URLs

During an audit, Spar picks one page to represent each page type (a product page, a collection page, and so on). Pinning a URL forces Spar to use that page instead.

  1. Click Add URL.
  2. Choose the page type on the left.
  3. Paste the full URL. You can add a short name in Template name (optional) to tell similar pages apart.
  4. Click Save changes.

You can pin up to 50 URLs. With nothing pinned, the audit picks pages itself. Use the trash icon to remove a pin.

Crawl scripts

Crawl scripts are small pieces of JavaScript that Spar runs on a page before it takes a screenshot, for example to close a drawer, pick a product variant, or wait for something to load. You only need them if captures of your site look wrong.

  • Site-wide pre-script runs on every page after Spar's normal page settling and before each screenshot. Turn Enabled off to skip it without deleting the code.
  • Per page-type scripts apply to a single page type. Pick one from Add page type… to add a Pre script (runs before the screenshot) and a Post script (runs after it). The Pre and post add to cart option runs on product pages around the add-to-cart click. Each page type has its own on/off switch and a trash icon to remove it.

Scripts can be up to 10,000 characters. Save with the bar at the bottom of the page.

Last updated on

On this page