Our first app, Migrato, is live on the Shopify App Store - free plan, no credit card. Take a look
Home / Documentation / Import / Export Metaobjects
Metaobjects Import/Export

Import / Export Metaobjects

How to import and export metaobjects in bulk with CSV and XLSX files.
5 min read Updated 14 October 2026 Applies to Migrato on all plans

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.

Metaobjects Import Video Demonstration
Metaobjects Import Video Demonstration
★
Before importing or exporting Metaobjects

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:

  1. Go to Apps → Migrato.
  2. Open the Import section.
  3. Select Metaobjects as the entity to import.
  4. Add the Metaobject file you want to import.
Metaobject Import
Metaobject 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
Upload Metaobject File
Upload Metaobject File

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:

Example
https://example.com/metaobjects.csv

Select Upload from URL after entering the file URL.

Import Metaobjects from URL
Import Metaobjects from URL
i
Note

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
Metaobject Import Details
Metaobject Import Details

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.

Metaobject Import Sheet
Metaobject Import Sheet

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.
Metaobject Import Operations
Metaobject Import Operations
!
Important

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.

Metaobject Import Options
Metaobject Import Options

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
Schedule Metaobject Import
Schedule Metaobject Import

Step 8: Start the Metaobject Import

After reviewing the file and selecting the required operation:

  1. Review the import details.
  2. Confirm the selected operation.
  3. Review the available options.
  4. Click Import.
Import Metaobjects Button
Import Metaobjects Button

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.

Metaobject Import in Progress
Metaobject Import in Progress

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
Metaobject Import Results
Metaobject Import Results

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:

  1. Go to Apps → Migrato.
  2. Open the Export section.
  3. Select Metaobjects.
Select Metaobjects for Export
Select Metaobjects for Export

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
Metaobject Export Fields
Metaobject Export Fields

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
Metaobject Export Filters
Metaobject Export Filters

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
Metaobject Export Completed
Metaobject Export Completed

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

Ready to run this on your own store?

Migrato's free plan handles 25 items per job - enough to follow any page in these docs end to end before you pay anything.

Free plan forever No credit card 2-minute setup Uninstall anytime