Creating entries

Metaobject entries store your customized data for your Shopify resources. The customized data is determined by the fields in your metaobject definition. After you create a metaobject definition, you can then add information in each entry for the fields from the definition.

For example, you can add in a metaobject definition named "Product highlights" with a heading, caption, image, and description. This definition creates the structure for each metaobject entry. You can make multiple "Product highlights" entries to display with specific products.

Category metafields come with default metaobject entries based on the standard product category. For example, if you add the product category Apparel & Accessories > Clothing > Shirts & Tops, then you can add category metafields for clothing size, neckline, sleeve length type, length type, age group, material, and color. All of these metafields have default metaobject entries that you can either use as is or customize further. You can use the color entry called black or customize the name to graphite to fit your brand better.

Create metaobject entries

  1. From your Shopify admin, go to Content > Metaobjects.
  2. Click into the metaobject definition that you want to add entries to.
  3. Click Add entry.
  4. Complete the fields for your entry. These fields are determined by the metaobject definition. The field that is marked as the Display name can be used to search for the entry.
  5. If you are creating a standard metaobject, then adjust the base values as needed. These values are predetermined by Shopify's standardized list of values.
  6. Optional: Set the status for your metaobject. New entries are set to Active by default. Active means it's ready to be displayed in your store, but it won't be displayed to customers until you publish it. If an entry is set to Draft, then you can't publish it to your store.
  7. Optional: If you are building a web page with the entry, then choose a theme template. You can click the eye icon to preview the template with your metaobject entry.
  8. Click Save.

After you create your entry, to use it dynamically in a part of your store, create a metafield reference for your custom entries. You can then connect entries on individual products or display them in your storefront using dynamic sources in your theme.

Entry handle

Your entry has a generated handle, which is a readable, URL-safe unique identifier specific to a single entry. You can edit the entry handle after you have started using entries in your store, but doing so isn't recommended. If you edit the entry handle and it's being used in other parts of your store, then this impacts any references manually set in your store, including in Liquid. Editing the entry handle can result in Liquid errors or not having an entry connected to your product, collection, and other areas of your Shopify admin.

Edit an entry

You can edit entries at any time by clicking on a metaobject definition from the Content > Metaobjects dashboard.

If the entry is published anywhere on your store, then your edits will automatically be reflected wherever the entry is used.

If you want to make changes to the fields that the entry uses, then you need to edit the metaobject definition and not the individual entry.


  1. In your Shopify admin, go to Content > Metaobjects.
  2. Click a metaobject definition that has an entry you want to edit.
  3. Click an entry to load the details.
  4. Make any required changes to the entry.
  5. Use the drop-down menu to set the status to Draft or Active.
  6. Click Save.

Add or edit entries for category metafields from the product page

Category metafields use metaobjects and have default entries that include a metafield references. You can edit them or add your own entries and associate them with a product category in the Shopify product taxonomy.


  1. In your Shopify admin, go to Products.
  2. Click the product with the entries you want to edit or add.
  3. In the Category section, click the category metafield, and then click the entry you want to edit or Add to add a new entry. If you are using the category metafield for your variants, then, in the Variants section, click Edit next to the variant. Then you can either click the entry you want to edit, and then click Edit, or click Add to add a new entry.
  4. Edit or add the fields. You can edit any base values associated with the taxonomy values. For example, if you want to change black to graphite, then you would select the Base color black, and then edit the Label to graphite.
  5. Click Save.

Delete an entry

Deleting an entry can't be undone.


  1. In your Shopify admin, go to Content > Metaobjects.
  2. Click a metaobject definition that has an entry you want to delete.
  3. Click an entry that you want to delete.
  4. Click Delete. Confirmation text displays to confirm that you want delete the entry.
  5. Click Delete to remove the entry.
Ready to start selling with Shopify?Try it free