Magento 2 to Shopify: Product Catalogue Migration Guide

On this page
Magento 2 to Shopify Migration: Product Catalogue Import Guide
Migrating a Magento 2 product catalogue to Shopify is not one problem: it is four. Magento 2 has four distinct product types, and each one behaves differently when it hits Shopify's import process. Getting configurable products to become Shopify variants is well documented. Getting grouped and bundled products to do anything useful in Shopify is not, because those product types have no native Shopify equivalent.
This guide covers the full execution path: exporting from Magento 2 admin, what to do with each product type before the import runs, the column mapping that reconstructs configurable product relationships, custom attributes as category metafields, and how to use Import History to verify the result.
The Four Magento 2 Product Types and What Happens to Each
Magento 2's product model is richer than Shopify's. Before exporting, understand what you are working with:
Simple products are single-SKU items with no variants. They import to Shopify cleanly as products with no variant complexity. If your catalogue is mostly simple products, the migration is straightforward.
Configurable products are parent records linked to child simple products, where each child is one variant combination (size S in Red, size M in Red, etc.). This is the standard variant structure. In Shopify, these become one product with variant rows. The relationship is reconstructable from the export file, but only if the column mapping is done correctly; this is the most common point of failure.
Grouped products are collections of standalone products shown together on one Magento product page. A grouped product might show a desk lamp, a lampshade, and a bulb together, each with its own price and stock. In Shopify, there is no grouped product type. Each component product must be imported separately. The "group" presentation is usually handled post-migration via a custom section or a Shopify collection.
Bundled products let the customer configure their purchase from a set of options (for example, a PC bundle where the customer selects a processor, RAM, and storage from dropdown menus). Shopify has no native bundle product type. Bundled products either become separate products post-migration (with upsell handled via a third-party app), or the simplest bundles can be modelled as variants if the option count is three or fewer.

Pre-migration decisions
What to Do Before You Export
For grouped and bundled products, the migration decision is structural, and it needs to happen before you touch the export file.
For grouped products: decide whether the components should be individual Shopify products or whether you want them grouped via a collection or a third-party app. In most cases, importing each component as a separate product and creating a Shopify collection to group them is the right call. Document the grouping relationships in a spreadsheet before the export so you can recreate them in Shopify.
For bundled products: assess whether the bundle's options fit within Shopify's 3-option ceiling. A PC bundle with Processor × RAM × Storage fits (3 option types, up to 100 variant combinations). A bundle with 4+ configurable axes (Processor × RAM × Storage × GPU) does not map natively and needs a third-party bundle app post-migration. For bundles that do not map, import the components as separate products and configure the bundle logic after the initial migration.
For the remaining configurable and simple products, the export process is straightforward.
Exporting Your Catalogue from Magento 2 Admin
In Magento 2 admin, go to Catalogue > Products. Use the filter to select the product types you want to export; start with configurable and simple products and handle grouped/bundled separately.
Go to System > Data Transfer > Export. Select Products as the entity type. Under Export File Format, choose CSV. Under Entity Attributes, you can exclude attributes you do not need in Shopify; removing attributes like meta_keyword, options_container, and Magento-internal fields reduces the export size and noise. Leave all attributes related to SKU, name, description, price, weight, images, and any attributes that contain data you want to keep as metafields.
Run the export. For large catalogues (10,000+ products), Magento generates the export asynchronously and emails a download link. For smaller catalogues, the CSV downloads directly.
The resulting CSV will have configurable products as parent rows with child simple product rows immediately below them. The parent row has a configurable_variations column listing the child SKUs. This is the data Importier uses to reconstruct the variant relationships.
The import

Column Mapping: Reconstructing Configurable Products as Shopify Variants
Open Importier and start a new import. Upload the Magento 2 export CSV. Importier reads the header row and auto-maps standard columns: name to Title, sku to SKU, price to Price, description to Body HTML.
The critical step is the variant structure. In the column mapping panel, map the Magento attribute columns that represent your variant axes:
colororcolourto Option 1 Name: "Colour"sizeto Option 2 Name: "Size"materialor the equivalent to Option 3 Name: "Material" (if used as a variant axis)
After column mapping, enable Smart Variant Detection. This reads the mapped option columns across all rows and groups configurable parent rows with their child simple product rows into Shopify products with variant rows. A Magento configurable product with 12 child products (4 sizes × 3 colours) becomes one Shopify product with 12 variants.
The most common Magento 2 migration failure is importing configurable products as individual products. Each child simple product becomes a separate Shopify product instead of a variant row. Smart Variant Detection prevents this by reading the parent–child relationship from the column data.
If your Magento export separates configurable parents and simple children in a way that breaks the grouping (this happens when the export is filtered or split), re-export with both types in the same file. Smart Variant Detection requires the parent row and all child rows to be present in the same import session.

Mapping Magento Custom Attributes as Shopify Category Metafields
Magento 2 uses attribute sets to store structured product data: Material, Care Instructions, Country of Origin, Compatible Devices, Wattage, and hundreds of other category-specific fields. These are the attributes that appear in Magento's product edit panels under the category-specific tabs.
When you export these attributes to CSV, they appear as columns. Without mapping them to Shopify structures, they disappear on import; Shopify's standard product fields have no place for them.
Shopify's standard metafield definitions define category metafields that correspond to many Magento attribute types. Importier's 22 Industry Packs map to this taxonomy. After column mapping and variant detection, apply the relevant Industry Pack for your product category: Apparel, Electronics, Home & Garden, Health & Beauty, and 18 others. The pack reads the attribute columns in the import and populates the matching Shopify category metafields.
For custom Magento attributes that do not map to a standard taxonomy field, Importier creates Shopify custom metafields using the attribute name as the namespace. These are readable in Shopify admin and surfaceable via Liquid or the Storefront API.
- 01Upload the Magento 2 export CSV to ImportierStart a new import session and drop in the CSV file. Importier reads the header row and proposes auto-mapping for standard fields
- 02Map the variant axesIn the column mapping panel, assign Magento attribute columns (color, size, material) to Shopify Option Name fields
- 03Enable Smart Variant DetectionImportier groups configurable parent rows with their child simple product rows into Shopify products with variant rows
- 04Apply the matching Industry PackSelect the Industry Pack that matches your product category to populate Shopify category metafields from Magento attribute data
- 05Generate AI descriptions for legacy copyRun the AI description generator on products whose description was last updated before 2022 (these are the highest-priority targets for copy refresh)
- 06Review the product list and push to ShopifyCheck the product preview, confirm variant structures and option names, then push to Shopify
Refreshing Legacy Magento Descriptions with AI
Magento stores often carry product descriptions written between 2015 and 2020. These descriptions may be supplier copy, thin text, or formatted for Magento's specific display template (with inline HTML tables and style attributes that do not render correctly in Shopify).
The migration is the right moment to refresh these. During the Importier import session, after variant detection and column mapping, enable the AI description generator. Select the AI model and description style that matches your brand, and run generation on the products whose current descriptions are below your quality threshold.
For large catalogues, run generation in batches by product type. High-value configurable products (the ones with the most variant complexity and usually the highest revenue) are the first priority. Simple products with thin descriptions are second. Products with existing strong copy can be skipped for the initial migration and updated via Store Scanner after the site is live.
The AI generator reads the product's title, attributes, and any existing description as context. For products where the existing Magento description contains useful information (ingredients, specifications, compatibility notes), leaving the existing description in the Body HTML column gives the AI more material to work with than leaving it blank.

Handling Magento Image Data
Magento stores product images as filenames with paths relative to the Magento media directory. The export CSV contains these paths in base_image, small_image, thumbnail, and additional_images columns. If your Magento server is still running during the migration, Importier can read these image URLs directly if you replace the relative paths with absolute URLs (prepend your Magento store URL and the media path).
If the Magento server will be decommissioned before or during the migration, export all product images from the Magento media directory before shutdown. Host them on a temporary location (a cloud storage bucket or a Google Drive folder) and update the image URL column in the export CSV to point to the new location. Importier supports Google Drive image import for catalogues stored in a shared Drive folder.
The post-migration URL redirect workflow for image paths follows the same pattern as other platform migrations: set up Shopify URL redirects from the old Magento image URLs before decommissioning the server.
Verifying the Migration with Import History
After the import completes, Import History provides a session-level audit trail. Go to Import History in Importier. Each session shows the date, time, source filename, and product count.
For a Magento 2 migration, check:
Product count matches expectation. If you imported 400 configurable products and expected them to become 400 Shopify products (not 2,400 simple product rows), verify the count. A count significantly higher than the configurable product count suggests variant grouping did not work correctly; the configurable parents may have been treated as separate products instead of variant groups.
Variant structure is correct. From Import History, download the imported CSV. Open it and check whether the Option Name columns (Colour, Size, etc.) are populated correctly. Each Shopify product should have one row per variant with the correct option values. A product with 12 variants should show 12 rows, not 1.
Category metafields populated. In Shopify admin, open a few products that had Magento attribute data and check the Metafields section. The Industry Pack attributes should appear as category metafields. If they are missing, check whether the Industry Pack was applied before the import was pushed.
- Configurable products import as separate simple products; variant structure lost
- Magento attribute data disappears with no Shopify field to receive it
- Legacy descriptions from 2015–2020 carry over unchanged
- No pre-import review; problems visible only after pushing to Shopify
- Manual audit of 400+ products to find grouping errors
- Smart Variant Detection groups configurable parents with child rows into Shopify variants
- Industry Packs map Magento attribute columns to Shopify category metafields
- AI description generator refreshes legacy copy during the import session
- Product list preview shows variant structure before pushing to Shopify
- Import History provides session-level count and downloadable CSV for verification

Cross-Platform Migration Context
If you have already migrated from WooCommerce to Shopify or are evaluating a BigCommerce to Shopify migration, the Magento 2 migration shares the core challenge of a source platform with richer product structures than Shopify's flat model, but Magento 2's configurable/grouped/bundled hierarchy adds complexity that WooCommerce and BigCommerce do not have.
The Shopify CSV import guide covers Shopify's native CSV format in detail if you need to understand what the final Shopify-side data structure looks like before the migration. The guide to importing products with variants covers the variant column format and option name rules in depth; worth reading before column mapping to understand how Shopify handles multiple option types.
Key Takeaways
- Magento 2 has four product types: simple, configurable, grouped, and bundled. Grouped and bundled products have no Shopify equivalent and require a pre-migration structural decision before the export runs
- Configurable products import incorrectly as separate simple products without Smart Variant Detection; this is the most common and hardest-to-fix Magento migration error
- Magento attribute set data maps to Shopify category metafields via Importier's Industry Packs; without this step, structured attribute data is lost on import
- The Magento 2 export CSV is the data handover document; take time with the attribute filter in System > Data Transfer > Export to include all columns you need
- Import History provides a session-level audit: product count, downloadable import CSV, and 60-day undo window
Start the migration at importier.app. The import wizard walks through column mapping, Smart Variant Detection, and Industry Pack selection before any products are pushed to Shopify.
Related Articles
Set up your first import in under five minutes.
Importier brings products into Shopify with AI descriptions, category metafields, and data enrichment on every run.
Free for your first 10 products. No credit card needed.


