URL mapping lets you set up redirects to guide visitors from old URLs to new ones, preventing 404 errors and maintaining SEO value. There are two main types:

301 Redirects (Permanent)

• Used for permanent URL changes
• Transfers SEO ranking to new page
• Best for deleted pages, URL changes, or domain redirects
• Search engines update their indexes

302 Redirects (Temporary)

• Used for temporary URL changes
• Maintains original page's SEO ranking
• Best for seasonal pages or temporary updates
• Search engines keep original page indexed

Creating Redirects:

1. Access Developer Tools > URL Mapping
2. Add redirect using format: /old-url -> /new-url 301
3. Click Save

Key Rules:

• Original URL must not exist
• New URL must be active
• Case-sensitive matching
• 400KB limit (≈2,500 redirects)
• Top redirects take priority
• No special characters (?, &, #)

Common Use Cases:

• Changed page URLs
• Deleted pages
• Imported content
• Moved collection items
• Cross-domain redirects
• Seasonal pages
• Temporary maintenance pages

For Blog/Collection Pages: Use [name] variable to redirect all items: /old-blog/[name] -> /new-blog/[name] 301

Troubleshooting:

• Check formatting (URL -> destination 301/302)
• Verify URLs exist
• Ensure case matching
• Remove special characters
• Check for redirect loops
• Monitor 404 errors

Best Practices:

• Use 301 for permanent changes
• Use 302 for temporary changes
• Remove unused redirects
• Place specific redirects before general ones
• Regularly audit redirects
• Test after implementation

Related Articles

Previous Articles