Skip to main content

​
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 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 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. For active pages, you cannot use redirect rules or 301 redirects.

​
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 with:
  • Your myshopify.com URL
  • Details of your redirect rule