> ## 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.

# Redirect rule not working

> If your redirect rule isn't working, check these common causes.

## Quick diagnostics

**Test the rule:**

1. Open an incognito browser window
2. Visit a URL that should match your rule pattern
3. Check if you're redirected

If not redirecting, continue troubleshooting below.

## Common causes

### 1. App embed not activated

**Most common issue:** Redirect rules require 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**

### 2. Usage quota reached

**Issue:** If you've hit your monthly tracked visits limit, redirect rules pause.

**Check:** Dashboard shows quota usage (e.g., "500 / 500 tracked visits").

**Fix:**

* Wait until quota resets next month
* [Upgrade your plan](/redirect-pro/guides/account-and-settings/manage-subscription) for more visits
* Convert high-traffic patterns to 301 redirects

### 3. Pattern doesn't match URL

**Issue:** The "Redirect from" pattern doesn't match the URL you're testing.

**Common mistakes:**

* Wrong pattern structure: `/blog/⑴` doesn't match `/news/post`

**Fix:** [Edit the rule](/redirect-pro/guides/working-with-redirect-rules/edit-delete-redirect-rules) to correct the pattern.

**Test patterns:** Try visiting multiple URLs that should match to verify your pattern.

### 4. Redirect from URL is active

**Issue:** Redirect rules only work on broken links (404 errors).

**Check:** Visit the URL you're testing. If a page loads instead of 404, the rule won't work.

**Fix:** Redirect rules are for handling broken URLs. To redirect visitors from active pages, use a [live redirect](/redirect-pro/guides/using-live-redirects/create-live-redirect) instead.

### 5. 301 redirect takes priority

**Issue:** If a 301 redirect exists for the URL, it will redirect before the rule can match.

**Check:** Search your URL Redirects list for the specific URL.

**Fix:** This is correct behavior - 301 redirects should take priority. Delete the 301 if you want the rule to handle it instead.

### 6. Browser caching

**Check:** Test in incognito mode or a different browser.

**Fix:** Clear browser cache or use incognito to verify the rule is working.

## Understanding redirect rule behavior

**Redirect rules are JavaScript-based:**

* Run in the visitor's browser (not server-side)
* Only activate on 404 error pages
* May show brief flash of 404 page before redirecting
* Provide no SEO benefits (use 301 redirects for SEO)

## Still not working?

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

* Your myshopify.com URL
* Details of your redirect rule