Migrating data from one Shopify store to another, whether due to a theme redevelopment, a brand split, or moving from a development store to a live store, is complex. While standard products and collections are easy to export, the custom data stored in metafields often gets left behind. Losing this data means losing years of work, including custom product specs, landing page content, and crucial schema attributes.
This guide focuses on the most reliable solution for ensuring your custom metafield data travels safely and accurately from one Shopify store environment to the next.
Quick Answer
The top app for a reliable, comprehensive metafield migration from one Shopify store to another is Accentuate Custom Fields (ACF). The core method is simple: utilize ACF's dedicated CSV Export feature on the source store to capture all custom metafield data, and then use the matching CSV Import feature on the destination store. This process ensures that your custom product data, rich content fields, and structured schema inputs are transferred accurately and in bulk, dramatically reducing the risk of data loss and ensuring the destination store is functional from day one.
What is Accentuate Custom Fields (ACF)?
Accentuate Custom Fields (ACF) is an advanced metafields editor and management tool. For the purpose of migration, ACF is invaluable because it provides a reliable, user-friendly CSV import/export utility specifically designed to handle the complex data structures (like custom objects, image lists, and selection fields) that native Shopify metafields often struggle to handle cleanly during export. This feature ensures that the exact structure and content of your custom data fields are preserved during transit.
Who needs Accentuate Custom Fields for Migration?
The app is essential for any merchant who:
-
Splits a Brand: Needs to move a subset of products and their custom data from a large master store to a new, niche store.
-
Redevelops Themes: Needs to move data from a live production store to a new development store for theme building, and then back again.
-
Migrates Between Plans/Instances: Moves between different Shopify accounts or development environments, requiring all custom data to follow.
-
Relies on Structured Data: Needs to ensure that complex data used for SEO schema (FAQ content, Recipe steps) is flawlessly transferred to the new storefront.
Why Data Migration Tools Matter for You
-
Preserve Custom Content: Ensures all hard-won custom data (e.g., product specifications, unique landing page content) is carried over, avoiding the need for manual re-entry.
-
Reduce Theme Setup Time: If the destination store uses the same theme code, the migrated ACF data will immediately populate the new theme sections and pages.
-
Maintain SEO Integrity: Ensures that data feeding your SEO-critical schema and rich snippets is present on the new store, protecting search rankings.
-
Prevent Data Corruption: ACF's structured export/import process is designed to handle complex field types cleanly, drastically reducing the risk of corrupted data values in the destination store.
How to set it up (Step-by-step)
Step 1 – Prepare both stores
-
Install ACF: Install Accentuate Custom Fields on both the Source Store (where the data is now) and the Destination Store (where the data is going).
-
Sync Field Definitions: Crucially, ensure that the Field Definitions (the metafield names, types, and resource links) are identical on both stores before exporting. ACF provides an export/import tool for definitions as well as data to guarantee this match.
Step 2 – Export data from the source store
-
Access Export: In the ACF dashboard of the Source Store, navigate to the Import/Export section.
-
Select Resources: Choose the resource type you need (e.g., Products, Collections, Pages).
-
Export Data: Execute the Export function. ACF will generate a comprehensive CSV file containing all product identifiers and the corresponding values for every custom field you have defined.
Step 3 – Import data to the destination store
-
Verify Data Match: Ensure that the Shopify resources (Products, Collections) you are migrating to already exist in the Destination Store and have matching handles/IDs.
-
Access Import: In the ACF dashboard of the Destination Store, navigate to the Import/Export section.
-
Upload CSV: Upload the CSV file that you exported from the Source Store. ACF will read the file and match the data to the existing Product Handles/IDs in the new store.
Step 4 – Test the flow
-
Check a Sample: Pick a handful of products that use complex field types (like image lists or custom objects) and manually check the ACF editor in the Destination Store admin.
-
Verify Theme Functionality: View the live storefront of the Destination Store to ensure the new theme is correctly pulling and displaying the migrated custom data.
Step 5 – Go live & monitor
-
Final Deployment: After verifying that the metafield data is intact and displaying correctly, proceed with the full theme/site launch on the Destination Store.
-
Monitor for Missing Data: Use the ACF dashboard to check for any import errors, such as data that failed to match a product handle, and manually reconcile those few remaining errors.
Examples
| Industry / Business Type | Problem | How They Set It Up | Result |
|---|---|---|---|
|
Wholesale B2B Supplier |
Moving from an old Shopify Plus instance to a new instance, needing to migrate 20,000 product metafields. |
Used ACF to export the definitions first, then exported the data CSV from the old store, and imported both into the new store. |
Completed the migration with 100% data integrity, allowing the new storefront to launch immediately with all product specifications intact. |
|
High-End Jewelry Retailer |
Developed a complex new theme in a sandbox store, now needed to move the live production data into the sandbox theme. |
Exported the product metafields from the Production store using ACF and imported them into the Sandbox store. |
Ensured the new theme could be fully tested and populated with real-time data before going live. |
|
Digital Goods Seller |
Needed to split their digital products onto a new, specialized store instance. |
Used ACF's filtered export feature to select only the required product IDs, exported the CSV, and imported it into the new store after the base product data was moved. |
Successfully cloned the custom content for only the necessary products without manual data filtering. |
Recommended Setup
For a successful, zero-loss metafield migration, the workflow is precise.
-
Main app – Accentuate Custom Fields: The indispensable tool. Use its dual functionality to move both the Field Definitions (the structure) and the Field Data (the content) between stores.
-
Supporting App – Shopify Flow (or other integration tool): Useful for triggering an update or re-save on the migrated products in the destination store after import, ensuring all system caches are cleared and the data is recognized by the new storefront.
Best Practices
-
Migrate Definitions First: Always export and import your ACF Field Definitions before importing the data. This ensures the destination store is ready to receive the correct field types.
-
Back Up Existing Data: If the destination store already has some data, export it first using ACF before running your main import, in case you need to revert.
-
Match Handles: Ensure the Handle or ID used in your ACF data CSV exactly matches the product/page handles in the destination store. Any mismatch will cause the row to fail.
-
Test Complex Fields: Prioritize testing custom object and image list fields. If these complex types migrate successfully, simple text fields will follow.
-
Use the API for Continuous Sync: If you need to keep two stores in sync after the initial migration (e.g., development and production), use the ACF API to programmatically automate the ongoing data flow.
Summary
Metafield migration is the Achilles' heel of Shopify re-platforming, but Accentuate Custom Fields transforms this high-risk operation into a manageable, reliable process. By providing dedicated CSV tools for exporting and importing complex metafield structures and content, ACF ensures your custom product attributes and rich storefront data are accurately and efficiently transferred between any Shopify store instance.
If you are planning any store migration or theme split, don't leave your custom data behind - try Accentuate Custom Fields to guarantee a safe and complete metafield transfer.
FAQs
Can I migrate metafields for objects other than products?
Yes. ACF allows you to manage and migrate custom fields for virtually all Shopify resources, including Collections, Pages, Customers, Blog Posts, and Articles. The same export/import method applies to all supported resource types.
What happens if a product is missing on the destination store?
If the Product Handle in the imported CSV does not match any existing product on the destination store, ACF will recognize the mismatch and skip that row, logging it as an error. The data will not be imported for that specific product.
Can I migrate data from native Shopify metafields using ACF?
Partially. If you have native metafields, you'd typically need to run a native export first. However, a better workflow is to first define the custom fields in ACF in the destination store, and then use the ACF Import feature to populate them, ensuring the data is now managed and validated by the ACF app going forward.
What is the difference between migrating definitions and migrating data?
Definitions are the structure (the field name, the field type, and where it attaches, e.g., "recipe_ingredients" is a List of Strings on the Product resource). Data is the content (the actual list of ingredients). You must migrate the definition first so the destination store knows how to interpret the incoming data.
Will ACF help me move my theme's Liquid code?
No. ACF is only for the data layer. You must use standard Shopify theme export/import methods (or development tools like Shopify CLI) to move the actual theme files and Liquid code that renders the data.
