Create MetaObjects: Difference between revisions

From Posstack.com Documentation
mNo edit summary
mNo edit summary
Line 43: Line 43:
* 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''')  
* 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''')  
:[[File:Add-entries.jpg|frameless|645x645px]]
:[[File:Add-entries.jpg|frameless|645x645px]]
* Next, click Select Entry > Create New Entry and complete the fields for your entry. Once done, click '''Save'''.  
* Next, click '''Select Entry''' > '''Create New Entry''' and complete the fields for your entry. Once done, click '''Save'''.  
:[[File:Add-entries-detail.png|frameless|750x750px]]
:[[File:Add-entries-detail.png|frameless|750x750px]]
:To create other entries, you repeat the exact steps by clicking Select Entry > Create New Entry. Note: If you have already created entries, simply click the checkboxes to determine which entries will be displayed on your storefront.   
: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.   
* Once done, click '''Save'''.
* Once done, click '''Save'''.



Revision as of 04:25, 23 August 2023

NOTE: This is a work-in-progress guide

Metaobjects are data containers that help you define and create custom structured data for your store, such as size charts, FAQs, ingredient lists, recipes, specifications, etc.

Easy Content Builder app helps you create metaobjects faster for 3 types of content:  

  • Icons with text (Type: ecb_icons_with_text)
  • Tabs (Type: ecb_tabs) - coming soon
  • Accordions (Type: ecb_accordions) - coming soon

Once you add the metaobjects mentioned above, the ECB app automatically creates metafield definitions that reference each metaobject respectively:

  • Product
  • Page
  • Blog post

How to create a metaobject

Note: Metaobjects are available for the Pro version only. Go Pro.

Step 1: Grant the Access Scope for Creating Metaobject Definitions by updating the App permission: [UPDATE APP]

Scope-access-notice.png
Note: If your store has multiple staff members, make sure you assign the right permission for staff to work on the metaobjects.
Staff-permission.jpg
Otherwise, your staff can not add entries when working with the metaobjects.
Permission notice.png

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:
Metaobject created.png
  •   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:
Metafields created.jpg
    • Click on each metafield Products, Pages, or Blog Posts to see the metafield definitions:
Metafield definitions.png

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)
Add-entries.jpg
  • Next, click Select Entry > Create New Entry and complete the fields for your entry. Once done, click Save.
Add-entries-detail.png
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. 
  • Once done, 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.