Back to Whitelisting Guide
Sh

Shopify

Authorizing PixelHarborBot with Web Bot Auth

Shopify Web Bot Auth

Shopify provides Web Bot Auth — an official way to authorize crawlers using cryptographic signatures. You can create signatures directly from your Shopify admin.

Web Bot Auth lets you securely authorize crawlers, scripts, and tools to access your public Shopify store. Create a signature in Shopify and add it to your Pixel Harbor account to enable authenticated scanning.

Create a Web Bot Auth Signature

Recommended

Create a signature in your Shopify admin and add it to your Pixel Harbor account:

Step 1: Create signature in Shopify

  1. Go to Online Store → Preferences in Shopify Admin
  2. Scroll to the Crawler access section
  3. Click Create signature
  4. Name it something like "Pixel Harbor Bot"
  5. Select your domain from the dropdown
  6. Set validity to 3 months (maximum)
  7. Click Create
  8. Copy the Signature and Signature-Input values

Step 2: Add to Pixel Harbor

  1. Go to Settings → Integrations
  2. Click Add Credential
  3. Enter your domain and paste the signature values
  4. Set the expiration date to match Shopify
  5. When creating a scan, select your credential from the dropdown

Important: Signatures expire after the validity period and cannot be renewed. You'll need to create a new signature in Shopify before it expires and update it in Pixel Harbor.

2

Alternative: Cloudflare DNS

If your custom domain DNS is managed by Cloudflare, you can whitelist at the Cloudflare level instead:

  1. Ensure your custom domain DNS is managed by Cloudflare (not just connected to Shopify)
  2. Follow our Cloudflare whitelisting guide
  3. Cloudflare rules apply before Shopify's protection layer

Note: This only works if Cloudflare is your DNS provider, not just if Shopify routes through Cloudflare.

3

Alternative: Direct Upload

If you prefer not to set up crawler access, upload images directly:

  1. Export your product images from Shopify Admin
  2. Go to Settings → Files in Shopify
  3. Download your images
  4. Upload them directly to Pixel Harbor as a ZIP file

Tips for Shopify Stores

  • Set the maximum validity (3 months) to minimize how often you need to renew signatures
  • Each signature is domain-specific — create one for each connected domain you want to scan
  • Shopify's CDN doesn't optimize images from older themes or oversized uploads — we handle both

Need Help?

Having trouble creating a signature? Contact us and we'll walk you through it.

Contact Support
Shopify Whitelisting Guide - Pixel Harbor | Pixel Harbor