Sample File
This sample file shows the basic columns that you need to set in order to import metaobjects to Shopify.
Download sample Metaobject Import File.
Before importing this sample data you will need to import the sample metaobject definitions first.
General
ID
Description | Example Value |
Shopify's unique metaobject identifier |
|
If present, the ID will be used to find an existing metaobject on the store. When importing, the ID will be used to see if the metaobject already exists. If there's no ID match the app will attempt to find an existing metaobject using the Handle.
Handle
Description | Example Value |
URL-friendly identifier |
|
The handle is the URL-friendly identifier for the metaobject. The handle is used for finding an existing metaobject on the store if the ID is not present and for grouping multiple rows together.
Command
Description | Example Value |
Action to perform: MERGE, DELETE, NEW |
|
MERGE: Update existing metaobject or create if not found
DELETE: Remove the metaobject from the store
NEW: Create a new metaobject (will fail if metaobject already exists)
Display Name
Description | Example Value |
Human-readable name |
|
The display name that appears in the Shopify admin and can be shown to customers if the metaobject is published.
Status
Description | Example Value |
Current status: ACTIVE, DRAFT |
|
ACTIVE: Metaobject is published and can be referenced
DRAFT: Metaobject is in draft state and not publicly available
Updated At
Description | Example Value |
Last modification timestamp |
|
The timestamp when the metaobject was last modified or updated.
Definition: Handle
Description | Example Value |
Type of metaobject |
|
The handle of the metaobject definition that defines the structure and fields for this metaobject.
Definition: Name
Description | Example Value |
Display name of the definition |
|
The display name of the metaobject definition that this metaobject is based on.
Top Row
Description | Example Value |
Whether this is the first row for this metaobject |
|
TRUE: This is the primary row for the metaobject
FALSE: This is a secondary row for additional field data
Row
Description | Example Value |
Row number for multi-row data |
|
Used when a metaobject spans multiple rows (e.g., when including multiple field values).
Field
Description | Example Value |
Metafield key |
|
The key of the metafield being set on this metaobject. The field must be defined in the metaobject definition.
Value
Description | Example Value |
Metafield value |
|
The value being set for the specified field. The format and type must match what's defined in the metaobject definition.
Export Filters
You can use these filters to limit which metaobjects are exported:
handle: Filter by metaobject handletype: Filter by definition typeupdated_at: Filter by last update date