Audits: Troubleshooting

Common reasons audits fail, take too long, or show unexpected results.

An Audit Is Stuck “Running”

• Some stores have slow pages, heavy scripts, or aggressive bot protection
• Temporary errors can occur when crawling multiple pages concurrently

Try running the audit again later, or reduce complexity by auditing after major changes are stable.

An Audit Failed

• Network errors or blocked page loads
• Password-protected storefronts
• Rate limits or quota limits

Issues Look Incorrect

Some issue detection involves heuristics and AI classification. Use recordings and heatmaps to validate impact, and test changes safely by duplicating your theme in Shopify before publishing.