Skip to main content

​
Choose your approach

You can create redirect rules in two ways: Create from template - Use pre-built patterns for common scenarios (quickest option) Create custom rule - Build your own pattern with wildcard tokens (most flexible)
Not sure which to use? Start with templates - they cover most common use cases. Use custom rules only when you need specific URL matching that templates don’t provide.

​
Create a redirect rule

1

Open Redirect Pro

From your Shopify admin, open the Redirect Pro app.
2

Go to Redirect Rules

Click Redirect rules in the app navigation menu.
3

Click Create Redirect Rule

Click the Create redirect rule button.
4

Enter your Redirect from URL

You can click Use template to start from the most common use cases, or enter a custom Redirect from URL. Use a least one wildcard token:
  • Use ⑴ to match any characters
  • Example: /products/⑴ matches /products/shoes
Start broad (e.g., /products/⑴) then narrow down if needed. Test with specific URLs to verify your pattern works.
5

Enter your Redirect to URL

In the Redirect to field, specify where matched URLs should go:
  • Use fixed paths: /new-path/page, or,
  • Use wildcard tokens to create flexible destination URLs based on the visited Redirect from URL: /new-path/⑴
6

Save the rule

Click Save in the contextual save bar at the top of the page. The redirect rule is now active and will start redirecting relevant traffic immediately.

​
Understanding wildcard tokens

​
Wildcard tokens: ⑴ ⑵ ⑶ ⑷ ⑸

Wildcard tokens match any set characters in a URL between two forward slashes. You can use up to 5 tokens per rule, numbered ⑴ through ⑸. Examples:
PatternMatchesDoesn’t Match
/old/⑴/old/page
/old/anything		/new/page
/old (no trailing path)
/blog/⑴/post/blog/2024/post
/blog/news/post		/blog/post
/blog/2024/article
/⑴-sale/winter-sale
/summer-sale		/sale
/discounts

​
Reusing tokens in the destination

Wildcard tokens capture text from the matched URL and can be reused in the redirect destination. Single token example: Rule:
  • Match: /products-old/⑴
  • Redirect to: /products/⑴
Result:
  • /products-old/shirt → /products/shirt
  • /products-old/blue-jeans → /products/blue-jeans
Multiple tokens example: Rule:
  • Match: /blog/⑴/category/⑵
  • Redirect to: /news/⑴/⑵
Result:
  • /blog/2024/category/updates → /news/2024/updates
  • ⑴ captures “2024”, ⑵ captures “updates”

​
Common redirect rules

Scenario: Unpublished or deleted products URLs to the all products page.Rule:
  • Redirect from: /products/⑴
  • Redirect to: /collections/all
Scenario: Unpublished or deleted collection paths to the all products page.Rule:
  • Redirect from: /collections/⑴
  • Redirect to: /collections/all
Scenario: Moved from /en/page structure to /pageRule:
  • Redirect from: /en/⑴
  • Redirect to: /⑴

​
Rule matching behavior

Important things to know:
  • 301s take priority - If a URL matches both a rule and a 301 redirect, the 301 will be used
  • 5 token maximum - You can use tokens ⑴ ⑵ ⑶ ⑷ ⑸ (no more than 5 per rule)
Always test your redirect rule after creation to ensure it matches the URLs you expect. See Test redirect rules.

​
After creating a rule

Once your redirect rule is saved: Immediate effects:
  • Rule starts matching URLs right away
  • Visitors are redirected automatically
  • Each activation counts toward your monthly tracked visits quota
Things to monitor:
  • Test with sample URLs to verify correct matching
  • Check rule matches (Enterprise) to see actual triggered URLs
  • Monitor your usage quota if you expect high traffic

​
Troubleshooting

Rule not redirecting? Check these common issues:
  • App embed disabled: Redirect rules require the app embed to be activated in your theme editor. Go to Theme Editor → App Embeds and enable Redirect Pro.
  • Quota limit reached: If you’ve used your monthly tracked visits, redirect rules pause until your quota resets. Check usage on the Settings page or upgrade your plan.
  • Pattern mismatch: Verify your test URL matches the URL structure from your rule. See Redirect rule not working.

​
Need help?

Having trouble creating a redirect rule? Check these resources: