Skip to content
Cartly Developers

Metaobjects

Create custom structured content types and render them in Liquid templates or query via the GraphQL Storefront API.

Overview

Metaobjects are standalone custom content types. Unlike Metafields, Metaobjects are schemas you design from scratch.

Definitions

POST /admin/metaobject-definitions. Set type (snake_case) and access.

Entries

CRUD: GET/POST/PUT/DELETE /admin/metaobjects/:type and /admin/metaobjects/:type/:id.

GraphQL

metaobjects(type) and metaobject(type, handle). admin_only returns empty.

Liquid

metaobjects.TYPE.entries in any template. 50/type, 250 total limit.

Cache

Redis version counter + Gcore CDN purge on mutations.

Field Types

single_line_text, multi_line_text, integer, decimal, boolean, date, date_time, url, color, json, rich_text, money, file_reference, product_reference, collection_reference, metaobject_reference