Import / Export Metaobjects
How to import and export metaobjects in bulk with CSV and XLSX files.Migrato allows you to import and export Shopify Metaobjects using CSV or XLSX files. You can select the required Metaobject fields, export existing Metaobject data, prepare data for import, and use filters to export only the Metaobjects that match specific conditions.
You can use Metaobject import/export to transfer, manage, update, or migrate Metaobject data in bulk instead of managing individual Metaobject entries manually through Shopify Admin.
We recommend reviewing the Metaobject Template Documentation and downloading the Metaobject Demo CSV/XLSX file, if available, to understand the supported fields and expected data structure.
Import Metaobjects
Migrato allows you to bulk import Shopify Metaobjects using CSV or XLSX files.
You can upload a prepared Metaobject file directly to Migrato or provide a publicly accessible URL to the file.
Step 1: Open Metaobject Import
From your Shopify Admin:
- Go to Apps → Migrato.
- Open the Import section.
- Select Metaobjects as the entity to import.
- Add the Metaobject file you want to import.
Step 2: Upload or Provide the Metaobject File
Migrato provides two ways to provide the Metaobject file.
Option 1: Upload a File
Upload or drag and drop your Metaobject file into the upload area.
Migrato supports:
-
CSV
-
XLSX
Option 2: Import from a Public URL
Instead of uploading the file manually, you can provide the full publicly accessible URL of the Metaobject file.
For example:
https://example.com/metaobjects.csv
Select Upload from URL after entering the file URL.
The file URL must be publicly accessible to Migrato. Files that require authentication or a login may not be accessible.
Step 3: Review the Import Details
After the file is uploaded or retrieved from the provided URL, Migrato creates an import job and displays the import details.
The displayed information may include:
-
Import ID
-
Import state
-
File format
-
Operation
-
Uploaded file
-
Import start information
Review the displayed information before continuing.
Step 4: Review the Metaobject Sheet
Migrato identifies the data contained in the uploaded file and displays it under the Sheets section.
Review the detected sheet before selecting the import operation.
Step 5: Select an Import Operation
Migrato allows you to select the operation to perform on the Metaobject data.
Depending on the supported Metaobject operations, available options may include:
-
Merge – Update existing records and create new records.
-
Create only – Create new records and skip records that already exist.
-
Update only – Update existing records and skip records that cannot be matched.
-
Replace – Replace existing matching records with the imported data.
-
Delete – Delete matching records where supported.
Carefully review the selected operation before starting the import, particularly when using Replace or Delete.
Step 6: Configure Import Options
Open the Options section to configure additional settings available for the Metaobject import.
Depending on the current Migrato configuration, available options may include job or result-file settings.
Step 7: Schedule the Metaobject Import
If scheduling is available for the selected operation, you can schedule the Metaobject import to run at a specified time or repeatedly.
Scheduling may include:
-
Schedule date
-
Schedule time
-
Repeat interval
-
Number of repetitions or run until cancelled
Step 8: Start the Metaobject Import
After reviewing the file and selecting the required operation:
- Review the import details.
- Confirm the selected operation.
- Review the available options.
- Click Import.
Migrato will begin processing the Metaobject import.
Step 9: Monitor the Import
Migrato processes the Metaobject import as a job and displays the current processing status.
Use the job information to monitor the import process.
Step 10: Review Import Results
After processing is completed, review the import results.
The results may include:
-
Import status
-
Total records
-
Successfully processed records
-
Failed records
-
Skipped records
-
Processing duration
-
Error information
If any records fail, review the reported errors, correct the source data where required, and run the import again.
Export Metaobjects
Migrato allows you to export Shopify Metaobject data into a downloadable CSV or XLSX file.
This can be useful for:
-
Metaobject data backup
-
Data analysis
-
Bulk data management
-
Store migration
-
Data processing
-
External system integration
-
Record keeping
Step 1: Open Metaobject Export
From your Shopify Admin:
- Go to Apps → Migrato.
- Open the Export section.
- Select Metaobjects.
Step 2: Select Metaobject Fields
Select the Metaobject fields you want to include in the export.
Migrato currently provides the following Metaobject field groups:
-
Basic Columns
-
Field Values
Select the fields required for your export.
Step 3: Apply Metaobject Filters
If you only need specific Metaobjects, use the Filters section to narrow down the export.
Migrato currently provides the following Metaobject filters:
-
Display Name
-
Definition: Name
-
Updated At
For detailed information about the available filters, see 7.3 Filter Metaobjects.
Step 4: Start the Export
After selecting the required fields and filters, start the export.
Migrato processes the selected Metaobject data and generates the export file.
Step 5: Review the Export Result
After the export is completed, Migrato displays the export result.
The result may include information such as:
-
Export status
-
Exported file name
-
File format
-
Number of records exported
-
Processing duration
-
Selected fields
-
Applied filters
You can download the generated CSV/XLSX file from the completed export screen.
Supported Metaobject Data
Migrato's Metaobject import/export functionality currently provides the following template groups:
| Group | Columns |
|---|---|
| Basic Columns | 9 |
| Field Values | 2 |
| Total | 11 |