Create MetaObjects

Easy Content Builder app allows you to create metaobject templates, a handy way to create custom structured data that's not available in the default Shopify data structure - such as Cooking Recipes, FAQs, Ingredient lists, Book metadata, Technical product specifications, etc.

With metaobjects, you can conveniently add unique content sections per product/page and manage those custom content in a centralized place.

This guide will walk you through what Shopify Metaobjects are, when to use metaobjects, and how to create a metaobject template using the Easy Content Builder app.

Creating a metaobject template with 6 types of metaobjects that Easy Content Builder provides (ECB Media, ECB Rich Text, ECB Tabs, ECB Accordion, ECB Icons With Text, ECB Author Bio) is available for the PRO plan only.

How to build a meta object template with Easy Content Builder.

Metaobject overview

What is Shopify metaobject?

Metaobjects are groupings of metafields. With metaobjects, you can create and manage entirely new custom data that's not natively available in your default Shopify data structure. Learn more about the difference between Metaobjects and Metafields here.

Metaobjects are ideal for showing custom data on your Shopify storefronts (such as Recipes, Size charts, FAQs, Ingredient lists, Material information, Book metadata, Technical product specifications, Product manual (pdf files), Author bio, etc.) or storing custom data for internal use in your Shopify admin.  

When to use metaobjects?

Metaobjects are handy when you want to add fully custom data per product/page using a single template. That means some (or all) products/pages have unique content sections specific to each product/page, even though they use the same Template.

Another helpful scenario in the metaobjects is creating a single content section that will be used in multiple pages, such as the Author Bio section. For example, display the same Author A bio block on 5 product pages. When you update the Author A Bio, all five products will automatically reflect your edits.

Metaobject use cases with Easy Content Builder

Combing Metaobjects and Easy Content Builder, you can:

• Create an entire page template using Metaobjects such as Recipes (view the demo 1, demo 2, demo 3), Books (view the demo), Artist bio (view the demo), Product specifications (view the demo 1, demo 2) etc.
• Add dynamic metaobjects (section, block, video, image, rich text) into specific parts per product/page (Note: these products/pages still use the same template).

NOTE: If you are new to Easy Content Builder, the app enables you to create:

• Template for multiple pages: create one template and apply it to multiple pages in bulk. More details.
• Template for single page: perfect when you want each page (product, page, article, etc) to have its unique template.  More details.  
• Template for standard pages such as Homepage, Collection pages, etc. More details.

How to create a metaobject template using Easy Content Builder

For demo purposes, this guide walks you through the steps to create a product page using metaobjects.

You can apply this workflow to create and display metaobjects in parts or an entire page/blog post/product.

What you’ll learn:

• Preparation: understand the types of Metaobjects you can use with the Easy Content Builder app
• Step 1: Create Metaobject definitions with just 1 click.
• Step 2: Create Metaobject entries (your custom data, e.g. recipe, materials, faqs, ingredients, etc.)
• Step 3: Create a metaobject template using Easy Content Builder.

Preparation: understand the types of metaobjects available in Easy Content Builder.

At present, Easy Content Builder allows you to create six types of metaobjects:

• ECB Media and ECB Rich Text metaobjects: you can use both of these metaobjects for creating long-form pages (cooking recipes, ingredient lists, product pages with complex specifications, bookstore pages, etc.) with rich content such as videos, images, icons, and rich text.

• • ECB Media: where you store rich media data such as videos, images, icons.
  • ECB Rich Text: where you store rich text data such as headings, subheadings, descriptions, etc.

• Metaobjects for specific blocks:

• • ECB Author Bio: allows you to store the writer, artist, author profile etc (such as name, position, avatar, and relevant information).
  • ECB Tabs: allows you to store tab content in metaobjects and display this dynamic content on a tab section on your theme using your Shopify theme editor. Read setup guide.
  • ECB Accordions: allows you to store accordion content in metaobjects and display this dynamic content on an accordion section on your theme using your Shopify theme editor. Read setup guide
  • ECB Icons With Text: allows you to store Icons With Text content (including Heading, Icons, Description, and Links) in metaobject and display this dynamic content on an Icons With Text section on your theme using your Shopify theme editor. Read setup guide.

IMPORTANT: If you need to add specific metaobjects - tabs, accordions, or Icons With Text  - to part of your Shopify pages, we highly recommend you use ECB Tabs, ECB Accordions, or ECB Icons With Text metaobjects depending on which content type you need. New to metaobjects? Learn when to use metaobjects here.

If you want to create a custom long-form page, then use ECB Media and ECB Rich Text Metaobjects by following these steps:

Step 1: Create Metaobjects

NOTE: Easy Content Builder provides a one-click option that enables you to create a metaobject definition automatically. No need to manually specify the metaobjects’ name, type, and fields like the native Shopify workflow.

• From your Shopify admin, navigate to Apps > Posstack Easy Content Builder > Metaobjects.
• Click on Create next to the ECB Media and ECB Rich Text content types. Once done, you should see two metaobject definitions (ECB Media and ECB Rich Text) automatically created with the message Metaobject and Metafield created:

• ECB Media is a group of fields where you store rich media data, including videos, images, and icons.
• ECB Rich Text is a group of fields where you store headings, subheadings, links, regular texts, and rich texts.

Step 2: Create entries for the metaobject.

What are entries?

Entries are custom data that you store in a metaobject.

For example, for each cooking Recipe page, you will add one entry (that contains Method, Ingredients, How-to steps, video or images, etc.). The metaobjects definitions (ECB Media and ECB Rich Text) we created in Step 1 above define these content fields automatically.

Why do you need to add entries to ECB Media and ECB Rich Text?

Your custom data might contain both media (video, image, icons) and rich text, so Easy Content Builder app lets you add and manage those data in two separate groups:

• ECB Media is where you create and manage all the media content you plan to use for the page, such as video (for featured videos, background videos), images (featured images, background images, gallery), and icons. You will create a separate ECB Media entry for each metaobject page.
• ECB Rich Text is where you create and manage the rich text you plan to use for the page (such as headings, subheadings, descriptions, etc.). Depending on which information you want to display on the storefront, you can enter your custom content into some or all of those pre-defined fields in metaobjects. You will create a separate ECB Rich Text entry for each metaobject page.

The screenshot below illustrates how entries stored in ECB Media + ECB Rich Text metaobjects are mapped with section fields in the Shopify theme editor.

• From your Shopify admin, select the part of your store that you want to add a metaobject to, for example, Products (or Pages, Blog Posts if you choose to).
• Click the name of a product you want to edit.
• In the Metafields section, you need to add entries for two metaobjects, ECB Media and ECB Rich Text.

• First, click on the ECB Media form field > click Select Entry > click Create new entry (If you already added entries before, simply select the one you want to use here).

• Then, complete the fields for your ECB Media entry. By default, ECB Media provides you with a wide list of fields below to use in different use cases, you can leave any fields blank if you have no related content for them yet.

• Entry Title: This field is for your internal use only. It helps to identify the entry in your Shopify admin. For example, you can enter “Recipe - Media’ if you are creating a media entry for a Recipe page.
• Featured Video: you can add up to 3 videos (e.g. How-to videos, tutorials, cooking guides, etc.)
• Background Video: you can add up to 2 videos to use as the background of a section.
• Feature Image: you can add up to 6 featured images.
• Icons: you can add up to 10 icons.
• Background Desktop: you can add up to 3 background images for the Desktop (e.g., Hero banners)
• Background Mobile: you can add up to 3 background images for the Mobile (e.g., Hero banners)
• Gallery Image:  you can add up to 12 gallery images (e.g. Before & After images in a cooking recipe or featured images of your product in different use cases, etc.)

• Next, follow the same steps to add entries to ECB Rich Text. Click on the ECB Rich Text form field > click Select Entry > click Create new entry (If you already added entries before, simply select the one you want to use here).
• Then, complete the fields for your ECB Rich Text entry. By default, ECB Rich Text provides you with a wide list of fields below to use in different use cases, you can leave any fields blank if you have no related content for them yet.

• Entry Title: This field is for your internal use only. It helps to identify the entry in your Shopify admin. For example, you can enter “Recipe - Rich Text’ if you are creating a rich text entry for a Recipe page.
• Heading: you can add up to 6 Headings.
• Subheading: you can add up to 6 subheadings.
• Text: you can add up to 18 text fields (we group these fields into three groups "group 1", "group 2", and "group 3" to make it easy for you to keep track of which group the text belongs to).
• Link: you can add up to 3 links.
• Rich text: you can add up to 6 rich text blocks.

• Click Save.

Once you hit Save, you successfully store all custom content in the metaobjects ECB Media and Rich Text.

Let’s move on to Step 3 to map those content fields to the sections/blocks through your Shopify theme editor (you determine which sections/blocks you want to link those metaobjects) and display them on your storefront.

Step 3: Create a metaobject template using Easy Content Builder.

What you will learn:

1. Create a metaobject page using Easy Content Builder (or edit an existing page if you already created one with Easy Content Builder).
2. Add (Easy Content Builder) sections you want to use on your page.
3. You connect the metaobjects created in Step 2 to each section of the metaobject template using dynamic sources within your theme editor.

Here are the steps:

Step 3.1: Create a new page using Easy Content Builder

We assume you can create a new page template using Easy Content Builder. You can easily create your first page following this guide if you're new to the app.

TIP: When creating a new template, you can create a blank template and add sections, blocks to the Template from the ground up. However, we highly recommend you use the pre-built metaobject templates provided by Easy Content Builder, a faster way to publish the metaobject page.

Steps to select a pre-built metaobject template:  

• From your Shopify admin, click Apps > Easy Content Builder > Browse Templates.
• Click on Metaobject Templates horizontal filter > Find the Template you want to use, then Choose Template.

Prebuilt Metaobjects templates provided by Easy Content Builder.

Step 3.2: Add sections/blocks to the meta object template

Now, let's start adding sections/blocks to the template and connecting the metaobjects to those sections/blocks through dynamic sources.

After you complete Step 3.1, you will be redirected to the Shopify theme editor, where you can start adding the sections/blocks to the Template.

If you want to edit an existing template you created with Easy Content Builder before, follow these steps:

• From your Shopify admin, click Apps > Easy Content Builder.
• From the Easy Content Builder dashboard, click Manage Templates.
• Then select the template that you want to edit and click Customize.
• From the Theme Editor, open each section/block you want to edit.
• Then click on Use Dynamic Sources icon next to the content fields to link individual entries with each field.

Example: Add a featured image stored in the ECB Media metaobject to an Image With Text section in Easy Content Builder.

An example of how to link a metaobject to a section using Dynamic Source.

You can follow similar steps to add Heading, Subheading, Rich text stored in ECB Rich Text metaobjects to the Image With Text section in Easy Content Builder.

Step 3.3. Assign the metaobject template to items (product, page, blog post).

You can follow one of the steps below depending on the type of pages you want to use:

• Assign the template to products: here.
• Assign the template to store pages or blog post: here.

How to create Author Bio metaobjects

<to be updated>

How to create Tabs/Accordions metaobjects

IMPORTANT:

• If you only need to add a specific metaobject - tabs, accordions, or Icons With Text - to part of your Shopify pages, we highly recommend you use ECB Tabs, ECB Accordions, or ECB Icons With Text metaobjects depending on which content type you need.
• If you want to create a custom long-form page, use ECB Media and ECB Rich Text Metaobjects by following these steps.

Step 1: Create Metaobjects

NOTE: This one-click option enables you to create a Tab/Accordion metaobject definition automatically.

• From your Shopify admin, navigate to Apps > Posstack Easy Content Builder > Metaobjects.
• Click on Create next to the desired content type (ECB Tabs, ECB Accordions, etc.). Once created, you should see the message Metaobject and Metafield created:

Step 2: Create entries for the metaobject.

• From your Shopify admin, select the part of your store that you want to add a metaobject to. For example, Products (Easy Content Builder now supports metaobjects for Products, Pages, Blog Posts).
• Click the name of a product you want to edit.
• In the Metafields section, click on the form field to add an entry (ECB Accordions, ECB Tabs depending on which metaobjects you created in Step 1)
• Then click Select Entry > click Create new entry. (If you already added entries before, simply select the one you want to use here).

• Complete the fields for your entry. These fields are determined by the metaobject.
• Click Save.

Step 3: Displaying metaobjects on your Online Store

You do so by connecting metaobjects to your Online Store through dynamic sources

• From your Shopify admin, click Apps > Easy Content Builder
• From the Easy Content Builder dashboard, click Manage Templates.
• Then select the template that you want to edit and click Customize.
• From the Theme Editor, open the Tabs/Accordion block where you want to edit.
• Then click on Use Dynamic Sources icon next to the block title.

Easy Content Builder app will automatically link all values defined under the related metaobject entries. No need to enter each entry values to each field.

• Once done, you can delete or edit any field of the Tab/Accordion block as you wish.

How to create a Icons With Text metaobject

IMPORTANT:

• If you only need to add a specific metaobject - tabs, accordions, or Icons With Text - to part of your Shopify pages, we highly recommend you use ECB Tabs, ECB Accordions, or ECB Icons With Text metaobjects depending on which content type you need.
• If you want to create a custom long-form page, use ECB Media and ECB Rich Text Metaobjects by following these steps.

Note: Connecting metaobjects to your Online Store through dynamic sources is available for the Pro version only. You can configure this setting normally in the Theme Editor, and you need to upgrade your plan to apply it to the front end. Go Pro.

Step 1: Grant the Access Scope for Creating Metaobject Definitions

Grant the Access Scope for Creating Metaobject Definitions by updating the App permission: [UPDATE APP]. This step is only needed if you install an old version of the Easy Content Builder.

Please discard this step for those who just installed the Easy Content Builder app. 

Note: If your store has multiple staff members, make sure you assign the right permission for staff to work on the metaobjects.

Otherwise, your staff can not add entries when working with the metaobjects.

Step 2: Create Metaobjects

• From your Shopify admin, navigate to Apps > Posstack Easy Content Builder > Custom Data.
• Click on Create next to the desired content type (Icons With Text, Tabs, Accordions). Once created, you should see the message Metaobject and Metafield created:

•   And all metafields associated with the above-mentioned metaobjects are automatically created too. You can check those metafields by following these steps:
  • In your Shopify admin, click Settings > Custom data
  • You should see 3 metafields Products, Pages, Blog Posts:

• • Click on each metafield Products, Pages, or Blog Posts to see the metafield definitions:

Step 3: Create entries for the Metaobjects

• From your Shopify admin, select the part of your store that you want to add a metaobject to. For example, Products (Easy Content Builder now supports metaobjects for Products, Pages, Blog Posts).
• Click the name of a product you want to edit.
• In the Metafields section, click on the form field to add an entry (ECB Accordions, ECB Tabs, or ECB Icons With Text depending on which metaobjects you created in Step 2)

• Next, click Select Entry > Create New Entry and complete the fields for your entry. Once done, click Save.

To create other entries, you repeat the exact steps by clicking Select Entry > Create New Entry. If you have already created entries, simply click the checkboxes to determine which entries will be displayed on your storefront. Here is an example of metaobject entries we created for demo purposes:

• Once done, click Save.

Step 4: Connecting metaobjects to your Online Store through dynamic sources

• From your Shopify admin, click Apps > Easy Content Builder
• From the Easy Content Builder dashboard, click Manage Templates.
• Then select the template that you want to edit and click Customize.
• From the Theme Editor, open the Icons With Text block where you want to edit. Then insert two classes into the CSS classes field: dynamic-source image-width-100 (replace 100 with the desired value for your icons' width).

Edit an entry

Please keep in mind that if an entry is published anywhere on your store, then your edits will automatically be reflected wherever the entry is used.

Steps to edit individual entries:

• In your Shopify admin, go to Content > Metaobjects.
• Click an entry you want to edit.
• Make any required changes to the entry.
• Use the drop-down menu to set the status to Draft or Active.
• Click Save.

Delete an entry

Caution: If you delete an entry, then it’s removed from anywhere it's published or used in your store. Deleting an entry can't be undone.

• In your Shopify admin, go to Content > Metaobjects.
• Click an entry that you want to delete.
• Click Delete to remove the entry.

Delete a metaobject

NOTE: You should only use the Delete functionality the Easy Content Builder app provides.

CAUTION: If you delete a metaobject, all associated metafields and entries will be removed from anywhere it's published or used in your store. Deleting a metaobject can't be undone.

• In your Shopify admin, go to Apps >  Easy Content Builder > Custom Data
• Click on Delete next to the metaobject that you want to delete.