- Short answer
- Not natively: as of October 2026, Shopify documents no CSV import for metaobject entries; bulk loads need an app or the Admin API.
- In the admin
- Content > Metaobjects adds entries one by one; no import or export in the docs we read
- Product CSV
- References entries by handle or GID in Option values and list.metaobject_reference metafield columns; creates none in the docs we read
- Without code
- An App Store app; Matrixify's Demo plan imports 10 entries per import
- With a developer
- metaobjectUpsert keyed by handle; by our reading, also a bulk mutation over a JSONL file up to 100MB
- Before importing
- Matrixify needs the definition first; referenced products must already exist
Does the Shopify admin import metaobject entries from a CSV?
No — in the admin you add entries one at a time: open a definition under Content > Metaobjects and click Add entry.
- Content
- Metaobjects
On the entries list we checked on October 30, 2026, the only header actions were Manage definition and Add entry. No Help Center page we read under custom data or product import/export, and no post in the Shopify changelog or, since October 30, 2024, the shopify.dev changelog, describes importing or exporting entries as of that date.
Neither bulk tool is documented as creating entries: the product CSV takes metaobject handles or GIDs in columns such as Option values and list.metaobject_reference metafields, and the bulk editor edits metafields.
Which bulk route fits: an app or the Admin API?
- Matrixify imports and exports entries; per import by Matrixify plan: Demo 10, Basic 50, Big 500, Enterprise unlimited
- MetaBulkify: CSV round trip with a dry-run preview
- Metaobjectify: handles and file URLs instead of IDs
- Structa: column mapping and validation
metaobjectUpsertcreates or updates an entry by handle- Needs the
write_metaobjectsscope, so an app such as a custom app bulkOperationRunMutationruns a mutation over a JSONL file up to 100MB; metaobject use is our reading of its “any mutation” rule
What has to exist before you import entries?
metaobjectUpsert matches on, and Shopify advises against editing it once entries are in use.- Files: files uploaded on the Files page can be used in metaobject entries; check how your app takes file fields.
- Products: a reference must point to an existing product, as Shopify documents for product CSV metafields.
- Standard metaobjects: in the admin, their entries need a Base value.
Test a few entries first: none of the Help Center or shopify.dev pages we read on October 30, 2026 describes how any of these import in bulk.
A definition holds up to 1,000,000 entries and 40 fields; our metafields guide covers the other limits.
This page was written by AI. Separate AI agents that did not write it check its figures and claims against official sources and test its links and interactive tools. A human editor sets the site's editorial direction, topics and rules and checks that pages are complete and display correctly, but does not check their facts or edit their text. Details may change — always confirm critical data at shopify.com.
Editorial Policy