Metaobjects

With the Matrixify app, you can bulk import and export Shopify Metaobject entries from Shopify Admin -> Content -> Metaobjects section.

See what each field/column from our “Metaobjects” template means including possible allowed values and examples.

Fields marked as “Export Only” cannot be imported/set in Shopify but can be exported with Matrixify export.

Excel Sheet Name

Metaobjects

When importing a file, to tell the app that you are importing Metaobjects, you need to ensure that the sheet/tab name is set to “Metaobject” or “Metaobjects”.

For example:

If using a CSV file then the file name can be “my-shopify-metaobjects.csv”
If using an XLSX file then the sheet/tab name would be set to “Metaobjects”. The file name for the XLSX file does not matter.

Even if the sheet/tab name is not set correctly, you will be able to manually change and set the entity you are importing after uploading file in the app.

See more on the Matrixify app import process and import user interface.

Need a quick start?

Download the Metaobjects Demo import file.

See Tutorials about Metaobjects.

Columns Available For Export And Import

Basic Columns

Column Description / Example Value

Column	Description / Example Value
ID	The ID is a Shopify automatically-generated internal ID number to identify the item. It is filled in by Export. Can be used for Import to identify and update existing Metaobject entries. When importing new Metaobjects, leave this column empty. Allowed Values Number Example 2927034435
Handle	The unique handle of the Metaobject. Can be updated and set when importing new Metaobjects. If left empty when adding new Metaobjects then Shopify will assign Handle from the Display Name. Can be used to identify existing Metaobjects when updating, but requires also to have Definition: Handle or Definition: Name specified in the import file as Handle is unique only for Metaobjects within the same Metaobject definition. Allowed Values Text Example peter-bloom
Command	When importing a Metaobject row – tell the app, what to do with it: `NEW`: will try to create a new Metaobject with the provided details. If such a Metaobject will already exist (with the same ID or Handle), then the result for that Metaobject will be Failed. `MERGE`: will try to find the existing Metaobject, and update it. If such a Metaobject will not be found, then it will create a new one. `UPDATE`: the app will search for an existing Metaobject by ID or Handle and update it. If it cannot be found then that item will fail to import. `REPLACE`: WARNING! Use this Command value to fully replace the whole file, not individual fields. Using this Command value, the app will delete the file from the store completely and create a new one only from data in the file, resulting in losing all data that is not included in the import file. If such Metaobject with provided ID or Handle exists, then the app will delete it. After that, it will create a new one using only the data from the import file. If an existing Metaobject will not be found, then still the app will create a new one. The difference from UPDATE is that it will not keep any of the columns, which were not included in the import file since the Metaobject will be deleted and re-created. `DELETE`: the app will delete the existing Metaobject, which is found by ID or Handle. If such a Metaobject will not be found, then the result will be Failed. This DELETE command is very handy for deleting Metaobjects in bulk. `IGNORE`: the app will ignore this Metaobject and will skip it. If no Command is specified, then the app will assume the MERGE command. Allowed Values NEW MERGE UPDATE REPLACE DELETE IGNORE Example MERGE
Display Name Export only	The preferred display name of the Metaobject. Cannot be set or updated. Shopify will take value from the Metaobject field that is set up in the Metaobject definition to be used as the display name. Allowed Values Text Example Peter Bloom
Status	Metaobjects status. New entries are set to `Active` by default. `Active` means it’s ready to be displayed in your store, but it won’t be seen by customers until you publish it. If an entry is set to `Draft`, then you won’t be able to publish it to your store. Allowed Values Active Draft Example Active
Updated At *Export only*	Date and time in the store’s timezone when the Metaobject was last updated. Cannot be set or updated. Allowed Values Date & Time Example 2023-06-07 11:53:09 +0300
Definition: Handle	The handle of the definition that the Metaobject entry is linked to. When adding new Metaobject entries, you must specify the definition that the Metaobject entry is linked to. The definition assigned cannot be changed for existing Metaobject entries. Allowed Values Text Example beekeeper_profile
Definition: Name *Export only*	The name of the definition that the Metaobject entry is linked to. When adding new Metaobject entries, you must specify the definition that the Metaobject entry is linked to. The definition assigned cannot be changed for existing Metaobject entries. Allowed Values Text Example Beekeeper
Top Row *Export only*	It will have value `TRUE` for each “top row” of the Metaobject. That can help you filter in Excel to get only the base rows, in case you need to get rid of repeated rows for each item. Allowed Values TRUE FALSE
Row # *Export only*	Will have row number from 1 till the end for each row. So that if you change the sorting in your exported file to easier update your data, you can sort it back by “Row #” and return it to the original sorting. Because, you know, all the item data should be together – and if you change the sorting, you need to sort it back. Allowed Values Number

The ID is a Shopify automatically-generated internal ID number to identify the item.
It is filled in by Export.
Can be used for Import to identify and update existing Metaobject entries.
When importing new Metaobjects, leave this column empty.

Allowed Values

Number

Example

2927034435

Handle

The unique handle of the Metaobject.

Can be updated and set when importing new Metaobjects.
If left empty when adding new Metaobjects then Shopify will assign Handle from the Display Name.

Can be used to identify existing Metaobjects when updating, but requires also to have Definition: Handle or Definition: Name specified in the import file as Handle is unique only for Metaobjects within the same Metaobject definition.

Allowed Values

Text

Example

peter-bloom

Command

When importing a Metaobject row – tell the app, what to do with it:

NEW: will try to create a new Metaobject with the provided details. If such a Metaobject will already exist (with the same ID or Handle), then the result for that Metaobject will be Failed.
MERGE: will try to find the existing Metaobject, and update it. If such a Metaobject will not be found, then it will create a new one.
UPDATE: the app will search for an existing Metaobject by ID or Handle and update it. If it cannot be found then that item will fail to import.
REPLACE: WARNING! Use this Command value to fully replace the whole file, not individual fields. Using this Command value, the app will delete the file from the store completely and create a new one only from data in the file, resulting in losing all data that is not included in the import file.
If such Metaobject with provided ID or Handle exists, then the app will delete it. After that, it will create a new one using only the data from the import file.
If an existing Metaobject will not be found, then still the app will create a new one. The difference from UPDATE is that it will not keep any of the columns, which were not included in the import file since the Metaobject will be deleted and re-created.
DELETE: the app will delete the existing Metaobject, which is found by ID or Handle. If such a Metaobject will not be found, then the result will be Failed. This DELETE command is very handy for deleting Metaobjects in bulk.
IGNORE: the app will ignore this Metaobject and will skip it.

If no Command is specified, then the app will assume the MERGE command.

Allowed Values

NEW
MERGE
UPDATE
REPLACE
DELETE
IGNORE

Example

MERGE

Display Name

Export only

The preferred display name of the Metaobject.

Cannot be set or updated.
Shopify will take value from the Metaobject field that is set up in the Metaobject definition to be used as the display name.

Allowed Values

Text

Example

Peter Bloom

Status

Metaobjects status.
New entries are set to Active by default. Active means it’s ready to be displayed in your store, but it won’t be seen by customers until you publish it.
If an entry is set to Draft, then you won’t be able to publish it to your store.

Allowed Values

Active
Draft

Example

Active

Updated At

Export only

Date and time in the store’s timezone when the Metaobject was last updated.

Cannot be set or updated.

Allowed Values

Date & Time

Example

2023-06-07 11:53:09 +0300

Definition: Handle

The handle of the definition that the Metaobject entry is linked to.

When adding new Metaobject entries, you must specify the definition that the Metaobject entry is linked to.

The definition assigned cannot be changed for existing Metaobject entries.

Allowed Values

Text

Example

beekeeper_profile

Definition: Name

Export only

The name of the definition that the Metaobject entry is linked to.

When adding new Metaobject entries, you must specify the definition that the Metaobject entry is linked to.

The definition assigned cannot be changed for existing Metaobject entries.

Allowed Values

Text

Example

Beekeeper

Top Row

Export only

It will have value TRUE for each “top row” of the Metaobject. That can help you filter in Excel to get only the base rows, in case you need to get rid of repeated rows for each item.

Allowed Values

TRUE
FALSE

Row #

Export only

Will have row number from 1 till the end for each row. So that if you change the sorting in your exported file to easier update your data, you can sort it back by “Row #” and return it to the original sorting. Because, you know, all the item data should be together – and if you change the sorting, you need to sort it back.

Allowed Values

Number

Field Values

Column	Description / Example Value
Field	Field key as specified in the Metaobject definition. Allowed Values Text Example description
Value	Field value to be saved in the Metaobject entry. The value set in this field will need to match the Metaobject definition validations. For example, if the field in definition is set as number integer, then you will only be able to set the field value as such aswell. Allowed Values Depends on the field type specified in the Metaobject definition Example A beekeeper from Latvia's Kurzeme region.

Column

Description / Example Value

Field

Field key as specified in the Metaobject definition.

Allowed Values

Text

Example

description

Value

Field value to be saved in the Metaobject entry.

The value set in this field will need to match the Metaobject definition validations. For example, if the field in definition is set as number integer, then you will only be able to set the field value as such aswell.

Allowed Values

Depends on the field type specified in the Metaobject definition

Example

A beekeeper from Latvia's Kurzeme region.

Export Filters

In the Matrixify app, you can apply filters to Export only specific Metaobject Entries from your Shopify Store.
When creating a new export, select the entity you wish to export, and under that entity click on the “Filters” button.

Note: The total displayed item count and estimated time won’t be affected by the filters applied as the app does not know how many items will match the applied filters.

Filter Description

Filter	Description
Display Name	Allows you to list specific Metaobjet Entry Display Names to export, separated by a comma. Possible Conditions `starts with any of` – whole Display Name starts with specific text. For example, the filter value `test` would match Display Name “Testing Example” but not “Example Testing”. `equals to any of` – whole Display Name matches the entered filter value `contains words that start with any of` – any separate word in the Display Name starts with the entered filter value. For example, the filter value `test` would match “Example Testing” and “Testing Example” Display Names, but would not find “Exampletest” or “Example 1testing”.
Updated At	Allows exporting Metaobject Entries which were last updated in the Shopify within a specific date range. Relative date condition allows you to export Metaobject Entries that have been updated in the last full amount of time. For example – Last 1 Days, would export Metaobject Entries from last full day, so yesterday. Possible Conditions `on or after` `on or before` `date range` `relative date`

Display Name

Allows you to list specific Metaobjet Entry Display Names to export, separated by a comma.

Possible Conditions

starts with any of – whole Display Name starts with specific text. For example, the filter value test would match Display Name “Testing Example” but not “Example Testing”.
equals to any of – whole Display Name matches the entered filter value
contains words that start with any of – any separate word in the Display Name starts with the entered filter value. For example, the filter value test would match “Example Testing” and “Testing Example” Display Names, but would not find “Exampletest” or “Example 1testing”.

Updated At

Allows exporting Metaobject Entries which were last updated in the Shopify within a specific date range.

Relative date condition allows you to export Metaobject Entries that have been updated in the last full amount of time.
For example – Last 1 Days, would export Metaobject Entries from last full day, so yesterday.

Possible Conditions

on or after
on or before
date range
relative date

Good to know

Metaobjects work similarly to Metafields but instead of being set for specific entities, they are defined and specified for the whole store itself. You can think of them as store-level Metafields.
Read Matrixify Metaobject related tutorials.
See how you can use Matrixify to import and export your Shopify Metafields as well.
Read more about Shopify Metaobjects in the Shopify Metaobject manual.
See the Shopify manual on how to include Metaobjects in your store.

Excel Sheet Name

Need a quick start?

Columns Available For Export And Import

Basic Columns

Allowed Values

Example

Allowed Values

Example

Allowed Values

Example

Allowed Values

Example

Allowed Values

Example

Allowed Values

Example

Allowed Values

Example

Allowed Values

Example

Allowed Values

Allowed Values

Field Values

Allowed Values

Example

Allowed Values

Example

Export Filters

Possible Conditions

Possible Conditions

Good to know

Start managing your Shopify data today!