VTEX URL Redirects Migration to Shopify

Last updated August 2026

A technical guide to handling url redirects migration when migrating from VTEX to Shopify. This covers what transfers, what does not, the specific risks for VTEX stores, and the recommended approach.

VTEX-specific considerations

When migrating url redirects migration from VTEX, the following platform-specific aspects must be considered:

Data model implications

VTEX's data model stores this information differently than Shopify. In VTEX: OMS order with marketplace/seller split, fulfillment, returns, and invoicing.

Can Shopify's Store Migration app handle url redirects migration?

What transfers

• 301 redirects from old URLs to new Shopify URLs
• URL pattern mappings for bulk redirects

What does NOT transfer

• Automatic redirect generation (must be created manually or via import)
• Platform-specific redirect rules (regex, conditions)
• Redirect chains (multiple hops should be collapsed)
• HTTPS enforcement rules (Shopify handles this automatically)

Specific risks for VTEX stores

• Missing redirects for high-traffic landing pages
• Redirect loops caused by incorrect mappings
• Exceeding Shopify's 100,000 redirect limit
• Redirects to deleted/archived products
• Query parameter handling differences
• Case sensitivity differences between platforms

Recommended approach

Export all URLs from the source platform (products, categories, CMS pages, blog posts). Map each URL to its Shopify equivalent. Create a URL redirect CSV and import via Shopify admin or API. Prioritize high-traffic URLs first. Test a random sample before bulk import.

Exporting url redirects migration data from VTEX

• VTEX Admin CSV export (limited)
• VTEX Catalog API (REST)
• VTEX Master Data API
• VTEX OMS API
• Third-party connectors

Technical notes

• Shopify URL Redirects: POST /admin/api/2026-07/graphql.json
• Format: { redirect: { path: '/old-url', target: '/new-url' } }
• Path must start with / and be relative
• Target can be relative (/products/new-slug) or absolute (https://)
• URL redirects only work on the primary domain
• Redirects are checked BEFORE Shopify's URL routing
• Regex-based bulk redirects are not natively supported in Shopify
• For complex redirect rules, use a proxy/CDN (Cloudflare Workers, Fastly)

Other VTEX migration issues

References

• Shopify URL Redirects — Shopify