· DataEase · Documentation  · 2 min read

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. (Import & Export)

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.

Share: