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 size, neckline, sleeve length type, top length type, age group, fabric, target gender, clothing features, 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.

Steps:

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 Standard Product Taxonomy.

You can edit or add new entries to your category metafields. You can edit entries from the product page in your Shopify Admin or from Content > Metaobjects. When you add new entries, they become available to add to any product connected to the category metafield. When you edit existing entries, they update everywhere that entry is connected.

Edit or add category metafields from the product page

You can add or edit category metafields from the product page for a specific product.

Steps:

Desktop

1. From your Shopify admin, go to Products.
2. Click the product with category metafields that you want to edit or add.
3. To edit or add category metafields on a specific product, do either of the following:
   • For category metafields connected to variant options: Click the variant option, and then click the option value field.
   • For category metafields that aren't connected to variant options: In the Category metafields section, click the category metafield.
4. Click the entry that you want to edit, and then click Edit.
5. Edit the fields as needed.
6. Click Save.

Edit or add entries for category metafields from the Content page

You can edit entries for your category metafields from the Content page in your Shopify admin on both desktop and in the Shopify app.

Steps:

Desktop

1. From your Shopify admin, go to Content > Metaobjects.
2. Click the definition name for the category metafield that you want to edit or add entries to.
3. Click the entry.
4. Edit the fields as needed.
5. Click Save.

Add entries to category metafields from the Content page

You can add new entries related to category metafields from the Content page in your Shopify admin on desktop. After you add a new entry, you can use that in any product with the category metafield.

Steps:

1. From your Shopify admin, go to Content > Metaobjects.
2. Click the definition name for the category metafield that you want to edit or add to.
3. Click Add entry.
4. Fill out the fields for your new entry.
5. Click Save.

Delete an entry

Deleting an entry can't be undone.

Caution

If you delete an entry, then it’s removed from anywhere it's published or used in your store.

Steps:

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.