Skip to main content

​
Quick diagnostics

Test tracking:
  1. Visit a non-existent URL on your store (e.g., yourstore.com/test-404)
  2. Wait 60 seconds
  3. Check the Broken Links page (both the “Unresolved” and “Hidden” tabs)
  4. If the URL appears, tracking is working
If not appearing, continue troubleshooting below.

​
Common causes

​
1. App embed not activated

Most common issue: Broken link tracking requires the app embed to be turned on. Check:
  1. Shopify admin → Online Store → Themes
  2. Click Customize on your live theme
  3. Click App embeds icon (puzzle piece)
  4. Find Redirect Pro
  5. Ensure toggle is ON
  6. Click Save
After enabling:
  • New broken link visits will be tracked
  • Test by visiting a 404 URL

​
2. Usage quota reached

Issue: If you’ve hit your monthly tracked visits limit, broken link tracking pauses. Check: Settings shows your quota usage (e.g., “500 / 500 tracked visits”). When quota is reached:
  • New 404 visits aren’t recorded
  • Existing broken links data remains visible
  • 301 redirects still work (unlimited)
Fix:
  • Wait until quota resets next month
  • Upgrade your plan for more visits
  • Create 301 redirects for existing broken links to free up future quota
Issue: The table only populates when customers visit 404 pages. Why it’s empty:
  • No one has accessed broken URLs yet
  • All URLs on your store are working
  • Recent install with no activity yet
This is normal:
  • New stores with no URL changes
  • Stores with comprehensive redirects already in place
  • Stores with no broken external links
Test it: Visit a non-existent URL to verify tracking is working.

​
4. URLs are already redirected

Issue: URLs covered by 301 redirects or redirect rules don’t appear in broken links. Why: If a URL redirects successfully, there’s no 404 error to track. Check:
  • Search your URL Redirects for the URL
  • Check if a redirect rule is catching it
  • This is correct behavior - redirected URLs won’t show as broken

​
5. Domain set up issues

It’s possible your domain configuration needs updating. If none of the soslution above resolve the issue contact us with your myshopify.com URL so we can help.

​
Understanding what gets tracked

Tracked:
  • ✓ Actual customer visits to 404 error pages on your store
Not tracked:
  • ✗ Internal broken links until customers visit them
  • ✗ URLs covered by 301 redirects (they redirect successfully)
  • ✗ URLs covered by redirect rules (appear in rule matches on Enterprise)
  • ✗ Server errors (500 errors)
  • ✗ Active pages (no 404 error)
Broken link tracking is visit-based, not a site crawler. It only detects 404s when visitors access them.

​
Still not working?

Get help: Contact support with:
  • Your myshopify.com URL
  • Broken URL you’re testing