> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scayla.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Broken link tracking not working

> If broken links aren't appearing in your Broken Links table, check these common causes.

## 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](/redirect-pro/guides/account-and-settings/manage-subscription) for more visits
* Create 301 redirects for existing broken links to free up future quota

### 3. No broken link visits yet

**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 solutions above resolve the issue, [contact us](/redirect-pro/help/support/contact-support) 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)

<Info>
  Broken link tracking is visit-based, not a site crawler. It only detects 404s when visitors access them.
</Info>

## Still not working?

**Get help:** [Contact support](/redirect-pro/help/support/contact-support) with:

* Your myshopify.com URL
* Broken URL you're testing