Import Metafields from CSV
Import metafield data from CSV files to create or update metafields in bulk.
The recommended workflow for importing metafields from a CSV is to first export a CSV with the fields you want to edit, modify them in an external spreadsheet application, and then import the CSV back into Metafield Studio.
Use Cases
- Copying metafield data from another Shopify store
- Importing spreadsheet data into metafields
- Bulk-populating metafields from external data sources
- Deleting metafields in bulk (with empty values)
Accessing
Navigate to Apps → Metafield Studio → Bulk Actions → Import
Required Columns
Every CSV file must include these 5 attributes:
| Column | Description |
|---|---|
| Resource identifier | Product ID, handle, SKU, customer email, etc. |
| Metafield type | The data type (string, number, reference, etc.) |
| Metafield namespace | The namespace grouping |
| Metafield key | The unique key identifier |
| Metafield value | The actual data to store |
The app automatically maps secondary identifiers (handles, emails, SKUs) to system IDs.
File Size Limits
| Plan | Max Upload Size |
|---|---|
| Free | Not available |
| Basic | 100 MB |
| Premium | 500 MB |
Supported Layouts
Columns Format
Each resource occupies a single row, with separate columns for each metafield. Best for working with spreadsheet editors.
Rows Format
Each metafield gets its own row, with the parent resource data repeated. Optimized for automation and data integrity.
Import Options
Empty Metafield Handling
- Preserve (default) Existing metafield values are kept when the CSV value is blank
- Delete Metafields with empty CSV values are removed
Duplicate Image Handling (file_reference type)
- Unique names (default) Generates unique filenames to avoid conflicts
- Replace Overwrites existing images with the same name
Tracking Progress
After starting an import, you can monitor progress in the History tab within Bulk Actions. Errors and results are available once the import completes.