Metafields & metaobjects

Before you begin

Metafields and metaobjects solve different problems

Recommended definitions

Product and collection data

Product siblings / Direct method

Connect colours sold as separate products

Use this method when every colour is a separate Shopify product and each group contains only a few products.

1. 1
   Open Product definitions

   Go to Settings → Metafields and metaobjects → Products → Add definition.

2. 2
   Create custom.siblings

   Name: Product siblings. Namespace and key: custom.siblings. Type: Product reference with List of products enabled.

3. 3
   Create custom.color_name

   Type: Single line text. Use customer-facing values such as Black, Ivory or Red.

4. 4
   Create custom.swatch when required

   Choose one type: Color for solid swatches, or File restricted to images for textures and photographs.

5. 5
   Complete every product

   Open the product, enter its colour name and select the entire group in Product siblings. The current product may be included; Sartelle removes the duplicate.

6. 6
   Repeat the same group

   Assign the same list to each colour product so customers can navigate from any sibling.

7. 7
   Configure the Sartelle block

   In the theme editor open Product → Product siblings and choose Image, Color or Text. Keep the custom namespace and siblings, color_name and swatch keys.

Product siblings / Metaobject

Use one shared group for larger catalogues

This method avoids rebuilding the same list on every product. One entry stores all colour products for the style.

1. 1
   Create the Sibling group definition

   Go to Settings → Metafields and metaobjects → Add metaobject definition. Use sibling_group as the type/handle and keep Storefront access enabled.

2. 2
   Add its fields

   Create name as Single line text and use it as the display name. Create products as Product reference with List of products enabled.

3. 3
   Create custom.sibling_group

   Under Product definitions add this namespace and key. Type: Metaobject reference restricted to Sibling group.

4. 4
   Create one entry per style

   Go to Content → Metaobjects → Sibling group → Add entry. Name it, select all colours in products and set the entry to Active.

5. 5
   Assign the same entry

   Open each colour product and select the same entry in custom.sibling_group.

6. 6
   Check the block settings

   Keep custom / sibling_group and the metaobject products field in Product siblings. A populated custom.siblings list takes priority over this shared group.

Brand metaobject

Create one reusable profile for every designer

1. 1
   Create the definition

   Go to Settings → Metafields and metaobjects → Add metaobject definition. Name and type: Brand / brand. Keep Storefront access enabled.

2. 2
   Add the fields

   Use the keys name, vendor, collection, genders, logo, image, description and size_chart. The Brand directory guide lists the correct type for each field.

3. 3
   Create entries

   Go to Content → Metaobjects → Brand. Create one Active entry for each brand and use the exact product Vendor.

4. 4
   Create custom.brand

   Under Product definitions create a single Metaobject reference restricted to Brand using custom.brand.

5. 5
   Connect products

   Open a product and select its Brand entry. Sartelle can now resolve the brand size_chart page.

Open the complete Brand directory guide →

Size charts

Use the most specific source available

Sartelle resolves size charts in this order: product page reference, brand metaobject size chart, gender-based page, then the fallback configured in the variant-picker block.

1. 1
   Create size-chart pages

   Under Online Store → Pages create general, Woman, Man, Kids or brand-specific charts.

2. 2
   For a product chart

   Create custom.size_chart_page as a Page reference under Product definitions and select the page on the product.

3. 3
   For a brand chart

   Complete size_chart on the Brand entry and connect the product using custom.brand.

4. 4
   For a gender chart

   Create custom.gender on Products as Single line text and use woman, man or kids. Select the matching three pages in the Variant picker block.

5. 5
   Set the fallback

   In Variant picker select a default size-chart page, or supply the fallback image and rich text content.

Product tags

Default merchandising labels

Tag names and customer-facing labels remain editable in Theme settings. Product tags are case-sensitive.