Skip to main content

metaobject

A metaobject entry, which includes the values for a set of fields. The set is defined by the parent metaobject_definition.

Properties

Basic information about the metaobject. These properties are grouped under the system object to avoid collisions between system property names and user-defined metaobject fields.

Directly accessible in

Returned by

Anchor to Access metaobjects individually

Access metaobjects individually

The access path for a metaobject consists of two layers:

  • type - The type of the parent metaobject definition.
  • handle - The unique handle of the metaobject.

Given this, you can access a metaobject with the following syntax:

{{ metaobjects.type.handle }}

You can also use square bracket notation:

{{ metaobjects['type']['handle'] }}

A metaobjects's field values can be accessed using the key of the desired field:

{{ metaobjects.testimonials.homepage.title }}
{{ metaobjects['highlights']['washable'].image.value }}

Note

When the publishable capability is enabled, a metaobject can only be accessed if its status is active. If its status is draft, then the return value is nil.


Anchor to Usage in metaobject templates

Usage in metaobject templates

Within a metaobject template, the metaobject Liquid object represents the metaobject drop being rendered by the template. You can access it directly as {{ metaobject }}.

Here's a basic example of accessing a field within the associated metaobject template:

{{ metaobject.title.value }}

In this example, replace title with the key of the field you want to access. This will output the value of that field for the current metaobject.

Was this section helpful?