🎉 30 days FREE!Claim Now

· MicroPIM Team · Platform Migration  · 10 min read

Migrating From Magento to Shopify: A Product Data Playbook for Catalog Managers

A concrete playbook for moving Magento EAV attributes, configurable products, and multi-store catalogs into Shopify without losing data.

Migrating From Magento to Shopify: A Product Data Playbook for Catalog Managers

AEO answer: Migrating from Magento to Shopify requires mapping Magento’s EAV attribute sets to Shopify metafields, converting configurable products into Shopify’s variant model, and consolidating any multi-store/multi-website structure into Shopify’s simpler catalog. Exporting via CSV or API and validating attribute mapping before go-live prevents data loss.


Why Magento-to-Shopify Migrations Are Different

Most “how to migrate to Shopify” guides treat the source platform as a generic catalog of products and prices. That works fine for WooCommerce or a hand-rolled catalog. It does not work for Magento, because Magento’s product model is structurally unlike Shopify’s in ways that break naive migrations.

Magento was built for merchants who needed unlimited custom attributes, per-store data overrides, and complex product relationships (configurable, bundle, grouped). Shopify was built for a flatter model: products, variants, and metafields. Neither approach is wrong, but the gap between them is where migrations go sideways.

Run a straight product export from Magento into a straight CSV import for Shopify, and you will lose attribute structure, scope-specific values, and probably some configurable products entirely. This playbook is written for the catalog manager who has to prevent that. For the general mechanics of moving any catalog into Shopify, see our Shopify catalog migration walkthrough; for a look at where these projects typically break, see what breaks during a Shopify migration.

Mapping Magento’s EAV Attributes to Shopify Metafields

Magento stores product data using the Entity-Attribute-Value (EAV) model, where each attribute lives in its own row rather than a fixed column, which is what lets merchants add hundreds of custom attributes but also makes the catalog hard to export cleanly. For how Magento’s EAV structure affects catalog export more broadly, including BigCommerce and WooCommerce comparisons, see How to Migrate Your Product Catalog to Shopify. The focus here is the decision logic: which attributes become core fields, which become metafields, and which get dropped.

Shopify has no EAV layer. It has a small set of core fields (title, description, price, weight, SKU, barcode) and an open-ended metafield system for everything else: namespaced key-value pairs attached to a product, variant, or other resource, with defined types (single line text, list, number, JSON, file reference).

The migration task is essentially: for every Magento attribute set, decide whether the attribute becomes a Shopify core field, a metafield, or gets dropped.

A practical mapping approach:

  1. Pull every attribute set and its assigned attributes from Magento admin (Stores > Attributes > Product) or via the REST/GraphQL API. Don’t rely on memory; attribute sets accumulate attributes over years that nobody remembers adding.
  2. Sort attributes into three buckets: core Shopify fields (title, price, SKU, weight, vendor, product type), filterable/storefront-facing attributes that need typed metafields, and internal/admin-only attributes that may not need to migrate at all.
  3. Create Shopify metafield definitions before importing data. Definitions (namespace, key, type, validation) work far better ahead of the import than created ad hoc per product; undefined metafields are harder to query in themes and in Search & Discovery filtering.
  4. Preserve attribute scoping deliberately. A “care instructions” attribute that differs by Magento store view has no direct Shopify equivalent unless you’re running Markets with market-specific metafield values, so decide up front whether you’re consolidating those values or need localized content.

MicroPIM sits between the two systems as the attribute mapping and validation layer, so these decisions live in one place instead of a spreadsheet that goes stale the moment someone adds a new attribute in Magento. See the Magento integration docs and Shopify integration docs for the field-level mapping mechanics.

Handling Magento Multi-Store and Multi-Website Setups

Magento’s multi-website/multi-store/store-view hierarchy is one of its most powerful features for merchants running several brands or regional storefronts from a single install, and it is one of the hardest things to migrate honestly.

A single Magento product can have different names, descriptions, prices, and visibility settings per store view, while still being “one product” at the website level for inventory and catalog purposes. Shopify has no equivalent. Each Shopify store is its own catalog. For region- or brand-specific content you either run separate Shopify stores, use a single store with Shopify Markets and market-specific pricing/content, or push localized content through metafields and a headless storefront.

Before migrating, catalog managers need to make an explicit decision, not an accidental one:

  • One Magento website maps to one Shopify store. This is the cleanest mapping if your websites are genuinely different brands or businesses, each with its own migration and product data.
  • Multiple Magento store views under one website collapse into one Shopify store with Markets, when the store views represent language or currency variants of the same catalog rather than different product assortments.
  • Store-view-specific visibility rules need to be rebuilt as Shopify collections or tags, since Shopify has no native “hide this product from store view B” toggle.

Pick a path before the data migration starts. Retrofitting a multi-store split after products already exist in one flat Shopify catalog means re-doing the export.

Migrating Configurable Products to Shopify Variants

This is where the largest structural difference lives, and where teams lose the most data if they rush it.

A Magento configurable product is a parent with no independent stock or price of its own, linked to a set of simple products (the actual sellable SKUs) via configurable attributes such as size and color. Each simple product child can carry its own full attribute set, images, and even a different price outside the configurable pricing logic.

Shopify’s variant model is a single product with a limited number of option dimensions, and each variant is a row within that one product, not a separate entity with its own attribute set. Variants share the parent product’s description, SEO fields, and most metafields unless you explicitly assign variant-level metafields.

What this means practically for the migration:

  • Configurable attributes (size, color) become Shopify product options, and each simple product becomes a variant. This part is mechanical and most migration tools handle it.
  • Attribute values that differ per simple product but aren’t configurable options (a child SKU with a unique material spec sheet, for example) need to become variant metafields, not product metafields, or the data ends up incorrectly shared across all variants.
  • Images assigned to specific simple products need to map to variant-level images in Shopify, a separate association from product images that is easy to get flattened during a CSV-based migration.
  • Configurable products with many differentiating attributes (a real pattern in Magento catalogs, especially B2B and industrial) don’t always fit Shopify’s option model directly. Consolidate attributes into fewer options, or represent the extras as filterable metafields rather than purchase options.
  • Bundle and grouped products have no direct Shopify equivalent and need to be rebuilt using a bundle app, since there’s no built-in bundle product type (as of this writing; check Shopify’s current native features and app ecosystem).

For a comparison of the two main ways to move this data, CSV versus direct API push, see our breakdown of Shopify CSV vs. API import. Configurable-to-variant conversions with variant-level metafields are generally more reliable over the API, since CSV variant rows are unforgiving about column formatting.

What Gets Lost in Translation (and How to Prevent It)

Be honest with stakeholders about what a Magento-to-Shopify migration cannot fully preserve, because “we migrated everything” is rarely true. For the full, source-agnostic failure analysis (variant images, metafield loss, inventory reset, URL and SEO impact), see What Breaks During a Shopify Migration (And How to Prevent It). This section covers only the failure modes specific to Magento’s EAV and configurable-product structure.

  • Layered navigation filters built on Magento’s EAV filterable attributes must be rebuilt using Shopify Search & Discovery filters against your new metafield definitions; the logic doesn’t come across automatically.
  • Custom product relations (related, up-sell, cross-sell) migrate as simple ID lists at best; Magento’s rule-based automatic relations need manual rules or an app on Shopify.
  • URL structure and SEO history. Magento’s URL rewrites and Shopify’s URL handles differ enough that a dedicated redirect map is required. Skipping this is a common cause of post-migration traffic drops.
  • Store-view-specific content either gets consolidated (losing nuance) or requires Markets/localization work outside the base migration.
  • Attribute set metadata like sort order and admin-only notes rarely has anywhere to go in Shopify and typically gets dropped, which is fine as long as it’s a decision, not an accident.

The way to prevent silent loss is to run a field-by-field mapping audit before exporting a single product, not after. A mapping sheet that says “this Magento attribute goes to this Shopify field or metafield, or is intentionally dropped” turns invisible data loss into a documented decision.

Migration Timeline and Checklist

A realistic timeline for a mid-sized catalog (2,000-20,000 SKUs with configurable products):

  1. Weeks 1-2: Audit and mapping. Pull attribute sets, store/website structure, and configurable product counts from Magento. Decide the store-mapping strategy, then build the attribute-to-metafield map and define Shopify metafields.
  2. Weeks 3-4: Pilot migration. Migrate one category end to end, including images, variants, and metafields, and check it against the live Magento product before trusting the mapping at scale.
  3. Weeks 4-6: Full catalog migration. Run the bulk export/import in batches if the catalog is large, to keep error handling manageable.
  4. Week 6+: Redirects and validation. Build the URL redirect map and run the validation pass below before flipping DNS or announcing the new store.

Post-Migration Validation

Before go-live, validate against the source, not just against “does the Shopify admin look populated.”

  • Spot-check configurable products across every product type, confirming variant options, variant images, and variant-level metafields all landed correctly.
  • Confirm metafield values render correctly in the storefront theme, not just the admin. Metafield types (list vs. single value) commonly get flattened incorrectly during import.
  • Verify inventory quantities and locations if you migrated from a multi-warehouse Magento setup.
  • Check that filterable navigation still returns correct product counts per filter, since this is the first thing merchandisers will notice if it’s wrong.
  • Confirm 301 redirects are live for every migrated Magento URL before removing the old store from search engines’ index.

Running validation through the same platform used for the mapping and import, rather than eyeballing the Shopify admin product by product, is what makes this step finish instead of dragging on for weeks. MicroPIM’s import validation tools flag mapping mismatches and missing required fields before they reach the live store.

Frequently Asked Questions

Do I need a developer to migrate Magento to Shopify? Not necessarily for the data migration itself. Attribute mapping, metafield setup, and variant conversion can be handled through a PIM without custom code. You are more likely to need developer help for theme work, redirect logic, and rebuilding automation that lived in Magento as custom modules.

Can I migrate Magento bundle products directly to Shopify? No, not as a native product type. Shopify has no built-in bundle product (as of this writing; check Shopify’s current native features and app ecosystem), so you’ll need a bundle app and will need to rebuild the bundle logic and pricing rules separately from the core data migration.

What happens to my Magento attribute sets after migration? They don’t transfer as a structure. Shopify has no equivalent concept tied to product types. The data itself transfers, mapped to core fields or metafield definitions you create; the organizational structure is something you recreate through metafield namespaces and Shopify’s own product categorization instead.

Should I migrate all store views or consolidate them? It depends on whether the store views represent genuinely different catalogs or just localized presentations of the same catalog. Different assortments usually warrant separate Shopify stores; localized presentations usually fit better into Shopify Markets on a single store.


Once migrated, keep Shopify in sync with your catalog going forward; see Shopify vs Magento vs WooCommerce: Which Has the Easiest Bidirectional Sync?.

Moving a Magento catalog to Shopify without losing attribute structure, variant relationships, or store-specific data takes more than a CSV export. Start a free MicroPIM trial to map your Magento attributes to Shopify metafields, convert configurable products to variants, and validate the catalog before you go live.

MicroPIM Team

Written by

MicroPIM Team

Founder MicroPIM

Entrepreneur and founder of MicroPIM, passionate about helping e-commerce businesses scale through smarter product data management.

"Your most unhappy customers are your greatest source of learning." — Bill Gates

Back to Blog

Related Posts

View All Posts »
Get Started Today

Start Using MicroPIM for Free

No credit card required. Free trial available for all Pro features.

Join other businesses owners who are using MicroPIM to automate their product management and grow their sales.

  • 14-day free trial for Pro features
  • No credit card required
  • Cancel anytime
SSL Secured
4.9/5 rating