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

Template Documentation

Every column in the Metaobjects template, what it holds and the values it accepts.
2 min read Updated 14 October 2026 Applies to Migrato on all plans

Metaobject Template Documentation

Migrato uses a structured template for importing and exporting Shopify Metaobject data.

The template defines the columns that can be used to transfer Metaobject information between Migrato and Shopify.

You can use the template to:

  • Prepare Metaobject data for import.
  • Understand exported Metaobject data.
  • Modify exported Metaobject data before re-importing.
  • Migrate Metaobject information.
  • Maintain a consistent Metaobject data structure.
★
Before preparing your file

Download the available Metaobject Demo CSV/XLSX file or export a sample Metaobject file from Migrato to understand the current template structure.

Metaobject Template Structure

The Metaobject template contains the following field groups:

  1. Basic Columns
  2. Field Values
Metaobject Template Groups
Metaobject Template Groups

1. Basic Columns

The Basic Columns group contains the primary information used to identify and describe a Metaobject entry.

Basic Columns
Basic Columns
Column Description Allowed Values / Examples
ID Unique Shopify identifier of the Metaobject entry. Shopify Metaobject ID
Handle Unique handle used to identify the Metaobject entry. Text — summer-collection
Status Current status of the Metaobject entry. Supported Shopify Metaobject status
Display Name Display name of the Metaobject entry. Text — Summer Collection
Updated At Date and time when the Metaobject entry was last updated. Date/time
Row # Identifies the row position in the template or exported data. Number
Top Row Indicates the top/header row information used by the template. Template value
Definition: Handle Handle of the Metaobject definition associated with the entry. Text — product_feature
Definition: Name Name of the Metaobject definition associated with the entry. Text — Product Feature
i
Note

The Definition: Handle and Definition: Name fields identify the Metaobject definition to which the entry belongs.

2. Field Values

The Field Values group contains the values stored in the fields of the Metaobject entry.

Field Values
Field Values
Column Description Allowed Values / Examples
Field Identifies the Metaobject field whose value is being imported or exported. Field key/name configured in the Metaobject definition
Value Contains the value assigned to the corresponding Metaobject field. Text, number, URL, date, reference, or other value supported by the field definition
!
Important

The Field and Value information should correspond to the Metaobject definition configured in your Shopify store. Make sure the field names and values follow the data types defined for the selected Metaobject definition.

Preparing a Metaobject Import File

When preparing a Metaobject import file:

  1. Download the Metaobject Demo CSV/XLSX file, if available.
  2. Review the Metaobject Template Documentation.
  3. Keep the required column names unchanged.
  4. Make sure the Definition: Handle or other definition information identifies the correct Metaobject definition.
  5. Enter the corresponding Field and Value information.
  6. Save the file as CSV or XLSX.
  7. Upload the file to Migrato or provide its publicly accessible URL.
  8. Review the import operation before starting the job.
★
Tip

Use a Migrato-generated Metaobject export as a reference when preparing data for a subsequent import.

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