Catalog Mapping
Catalog mapping is the step in a migration where product data gets translated from one platform's structure into another's. Different platforms model products differently. The mapping document is how you make sure nothing collapses, splits incorrectly, or disappears.
A typical mapping for a Shopify Plus migration covers: product titles, descriptions, vendor, product type, tags, status, SEO fields, prices, compare-at prices, costs, SKUs, barcodes, weight, inventory quantity, inventory location, options (size, colour, material), variants, variant images, product images, alt text, and metafields.
Magento configurable products may become Shopify products with variants, but confirm the option and SKU relationships first. For bundles, assess Shopify Bundles for fixed bundles or multipacks, or a suitable app or custom bundle approach for other requirements. Grouped products may use collections or a different buying experience. Map custom attributes to appropriate standard fields, metafields or metaobjects; design categories, collections, navigation and filters separately rather than assuming a one-to-one category-tree copy.
Approve the mapping before the main import, then test it with representative products, variants, bundles and inventory locations. It becomes the specification for the chosen import tools or scripts. Reconcile records and test the storefront: an imported field is only useful if the buying experience and integrations use it correctly.
Frequently asked questions
What is catalog mapping in a migration?
Catalog mapping defines how source product data translates into the target store. It records fields, identifiers, relationships and transformation rules, and becomes the specification for import tools or scripts. Test it with representative records before the full migration.
How do Magento configurable products map to Shopify?
A configurable product can map to a Shopify product with variants when its options and SKU relationships fit. Map attributes into suitable fields, options, metafields or metaobjects. Category trees need a deliberate collections, navigation and filtering design rather than a literal copy.
What happens if you skip catalog mapping?
Skipping mapping increases the risk of missing variants, broken filters, duplicate products and incorrect inventory or pricing. Approve the model, test representative records and reconcile the result before launch.
Related terms: EAV Data Model, Metafields, Migration Sandbox. For hands-on help, see how Flux runs Shopify Plus migrations.
Shopify Plus development and AI search
We build Shopify Plus stores that customers and AI shopping agents can find, compare and buy from. 210+ stores since 2012.
Chosen by Shopify Plus brands worldwide.














