Building a metaobject

You can create metaobjects from two locations in your Shopify admin:

  • From Content > Metaobjects
  • From Settings > Custom data

When you create a metaobject definition, you specify the following information:

  • Name: used to identify the metafield in your Shopify admin, such as Authors.
  • Type: the type of data that the metafield stores, such as text, file, or URL.
  • Fields: define the type of content you want to display in the metaobject
    • Each field has a name (required), description, type, and validation rules, such as character limits, minimum and maximum values, or preset values.
    • Display name is assigned to a single field name and is used to identify an individual metaobject entry. You can change the field that the display name is assigned to at any time. The display name is automatically assigned to the first text field in a metaobject entry, or autogenerated if there are no text fields in the metaobject definition.
    • For example, you might add a field for text and indicate it as a display name, a field for an image, and a field for color.
  • Options: where the metaobject is available to use.
    • Access: By default, Storefronts access is activated for your metaobject. This means that the metaobject can be connected in your theme using dynamic sources. You can deactivate Storefronts access. Learn more about access options.
    • Features: You can use the metaobject to create Web pages. Learn more about building web pages with metaobjects.

Create a metaobject


  1. From your Shopify admin, go to Content > Metaobjects or Settings > Custom data.
  2. Click Add definition.
  3. In the Name field, enter a name for your definition. A type for your metaobject is automatically generated, and can be edited prior to saving the metaobject.
  4. Click Add field and select the content type you want to contain in this metaobject. For example, single line text. Each field has its own set of options and validation rules.
  5. Configure the field and its validation information:
    1. Enter the Name of the entry.
    2. Optional: In the Description field, enter a description for your metaobject.
    3. Optional: Select Use this field as display name to use the field as the display name to search in the index.
    4. Configure the validation rules for the field, and then click Done.
  6. Add additional fields to your metaobject as needed.
  7. Optional: To turn off storefront access, deselect Storefronts from the Access section.
  8. Optional: To allow entries from this metaobject to be published as stand-alone pages, select Web pages under Features.
  9. Click Save.

After your metaobject has been saved, you can start creating entries.

Delete a metaobject

Deleting a metaobject can't be undone. If you delete a metaobject, then all the entries for that metaobject will also be deleted.


  1. From your Shopify admin, go to Settings > Custom data.
  2. In the Metaobjects section, click the metaobject that you want to delete.
  3. Click Delete. A confirmation dialog displays to confirm that you want delete the definition.
  4. Click Delete to remove the definition.
Can't find answers you're looking for? We're here to help you.