Metaobjects

A Metaobject is a custom data record built from a Metaobject Definition (for example, “Size Chart” or “Store Locator”).
With DataEase you can:

• Create many metaobjects from one sheet.
• Update or delete records by handle or id.
• Add or change field values without opening the admin.

Shopify’s metaobject guide.

---

Table of Contents

1. Export
2. Import
3. Field reference
4. Filters

---

2. Export

1. Choose CSV or Excel.
2. Pick Metaobject as the entity.
3. Select fields like handle, type, or fieldValue.
4. Run the task and download your file.

See pictures in the Export guide.

---

3. Import

Supported commands in command column: CREATE, UPDATE, REPLACE, DELETE, IGNORE

Important rules

• handle is required for all commands except IGNORE and DELETE.
• Keys in fieldKey must match the definition. Values in fieldValue must match the field type.
• First row holds main metaobject info (handle, status, etc.). Extra rows for the same object only need fieldKey and fieldValue.
• Matching happens by handle first, then by id (id works only for DELETE or REPLACE).

Steps:

1. Download the sample file: Metaobject-import-sample.xlsx
2. Edit rows or add new ones.
3. In DataEase, map columns, upload, and start the import.

Full help: Import guide

---

4. Field reference

• id — Unique metaobject ID. Needed for DELETE or REPLACE. (Import & Export)

• displayName — Preferred display value shown in pickers. (Export only)

• handle — Custom unique string (works like an ID). (Import & Export)

• status — ACTIVE or DRAFT. Controls public visibility. (Import & Export)

• updatedAt — Last update time (ISO 8601). (Export only)

• type — Definition type (e.g., size_chart). (Import & Export)

• templateSuffix — Theme template suffix for storefront view. (Export only)

• command — CREATE, UPDATE, REPLACE, DELETE, IGNORE. (Import & Export)

Definition info

• definitionId — ID of the metaobject definition. (Export only)

• definitionName — Name of the definition. (Export only)

• definitionDisplayNameKey — Key used as display name. (Export only)

• definitionDescription — Admin-only description text. (Export only)

Field rows

• fieldKey — Key of the field you want to set, e.g., image or chart_html. (Import & Export)

• fieldValue — Value for that key. Must match the field type in the definition. (Import & Export)

---

5. Filters

• Id — Export one metaobject by id.

• DisplayName — Export metaobjects whose display name contains the text you enter.

• Handle — Export metaobjects where handle equals or contains the text you enter.

• UpdatedAt — Choose a last-updated date or range.

---

Need help? Our support team replies within 24 hours.