November 21, 2025

How To Setup Shopify Designers or Brands With Metaobject & Metafields - SOP

By Veronica Jeans, Bestselling Author

Store: Itsy Bitsy Boutique

Theme: Someone You Know Xclusive

Purpose: Display designer information dynamically on product pages

Last Updated: November 20, 2025

Overview

This SOP explains how to set up designer information that displays automatically on product pages using Shopify's metaobjects and metafields system.

What You'll Create:

  • Designer Metaobject - A database of all your designers with their info
  • Product Metafield - A connection that links products to designers
  • Section Files - Display templates that show designer info on product pages

End Result:

When a product is connected to a designer, the product page automatically displays:

  • Designer name (linked to collection)
  • Designer logo
  • Description
  • Country of origin
  • Size chart button
  • Care instructions
  • "NEW" badge for new designers
  • Links to shop all products by that designer

Prerequisites

  • ✅ Shopify store with admin access
  • ✅ Theme that supports Shopify 2.0 sections
  • ✅ Basic understanding of Shopify admin
  • ✅ List of designers you want to add

Part 1: Create Designer Metaobject

⏱️ Time Required: 10 minutes
📅 Frequency: One-time setup

Step 1.1: Access Metaobjects

  1. Log into Shopify Admin
  2. Go to Settings (bottom left corner)
  3. Click Custom Data
  4. Click Metaobjects tab at top
  5. Click Add definition button

Step 1.2: Create Metaobject Definition

Field Value Notes
Name Designers Display name (can be anything)
Type designers System identifier (lowercase, no spaces)
⚠️ CRITICAL: The Type field becomes permanent after you save and add entries. Choose carefully!

Step 1.3: Add Metaobject Fields

Click Add field for each field below:

Field 1: Designer Name

  • Type: Single line text
  • Name: Designer Name
  • Key: designer_name
  • Required field
  • Use as a display name

Field 2: Description

  • Type: Multi-line text
  • Name: Designer Description
  • Key: designer_description
  • Description: "Brand story and description"

Field 3: Country

  • Type: Single line text
  • Name: Country
  • Key: country
  • Description: "Country of origin (e.g., USA, Italy)"

Field 4: Logo

  • Type: File (Image)
  • Name: Designer Image Logo
  • Key: designer_image_logo
  • Description: "Designer logo for product pages"

Field 5: Size Chart

  • Type: File (Image)
  • Name: Size Chart
  • Key: size_chart
  • Description: "Size chart image (will open in popup)"

Field 6: Care Instructions

  • Type: Rich text
  • Name: Care Instructions
  • Key: care_instructions
  • Description: "Care and washing instructions with formatting"

Field 7: New Brand Flag

  • Type: True/False
  • Name: New Brand
  • Key: new_brand
  • Description: "Check if this is a new designer (shows NEW badge)"
  • Default: False

Field 8: Designer Collection

  • Type: Collection reference
  • Name: Designer Collection
  • Key: designer_collection
  • Description: "Link to a collection of all products by this designer"
  • Validation: One value

Field 9: Website URL

  • Type: Single line text
  • Name: URL
  • Key: url
  • Description: "Designer's website URL"

Field 10: Featured

  • Type: True/False
  • Name: Featured
  • Key: featured
  • Description: "Feature this designer on homepage/directory"
  • Default: False

Field 11: Blog Posts

  • Type: Blog post reference
  • Name: Blog Posts
  • Key: blog_posts
  • Description: "Link to blog post about designer"
  • Validation: One value

Field 12: Display Order

  • Type: Integer
  • Name: Display Order
  • Key: display_order
  • Description: "Number for sorting designers (1, 2, 3...)"

Step 1.4: Configure Access and Publishing

Access:

  • Storefront access: Enable

Web pages:

  • ☐ Web pages (leave unchecked unless you want individual designer pages)

Step 1.5: Save

  1. Review all fields
  2. Click Save button (top right)
  3. You should see confirmation: "Metaobject definition created"
✅ Checkpoint: You now have a "Designers" metaobject type with 12 fields

Part 2: Create Product Metafield Definition

⏱️ Time Required: 5 minutes
📅 Frequency: One-time setup
⚠️ IMPORTANT: Shopify does NOT allow duplicate keys. If you get an error about "key already exists," you need to choose a different key or delete the existing one.

Step 2.1: Access Product Custom Data

  1. Go to SettingsCustom Data
  2. Click Products tab at top
  3. Click Add definition button

Step 2.2: Create Metafield Definition

Field Value Notes
Name Designer Display name in product editor
Description Links product to a designer Optional helper text

Step 2.3: Set Namespace and Key

⚠️ CRITICAL STEP - READ CAREFULLY
  1. Click Select namespace and key
  2. A modal will appear

For Namespace:

  • Select: custom from dropdown

For Key:

  • Type: designer (lowercase, singular, no spaces)
  • IMPORTANT: If Shopify says "This key already exists," try these alternatives:
    • designer_info
    • product_designer
    • brand
    • designer_reference
  1. Click Add to confirm

Final result should show:

custom.designer

OR whatever alternative key you chose

📝 WRITE THIS DOWN: Your key is custom.[your_key_here]
You'll need this exact key for the liquid code later!

Step 2.4: Select Field Type

Type: Metaobject reference

  • From dropdown, select: Metaobject reference

Validation:

  • Select: One value (not "List of values")

Metaobjects:

  • From dropdown, select: Designers

Step 2.5: Configure Display

Options:

  • Pin this metafield (optional - makes it easier to find)

Step 2.6: Save

  1. Review all settings
  2. Click Save button
  3. You should see confirmation: "Metafield definition created"
✅ Checkpoint: You now have a product metafield that connects to designers

Part 3: Add Designer Entries

⏱️ Time Required: 5-10 minutes per designer
📅 Frequency: As needed when adding new designers

Step 3.1: Access Metaobject Entries

  1. Go to ContentMetaobjects
  2. Click on Designers from the list
  3. Click Add entry button

Step 3.2: Fill in Designer Information

Required Fields:

  • Designer Name: Enter designer name (e.g., "Lulu + Roo")

Optional but Recommended:

  • Designer Description: Brand story, heritage, philosophy
  • Country: Country of origin
  • Designer Image Logo: Upload logo (PNG with transparent background works best)
  • Size Chart: Upload size chart image
  • Care Instructions: Add formatted care instructions
  • New Brand: Check if new (shows NEW badge)
  • Designer Collection: Select the collection for this designer's products
  • URL: Designer's website
  • Featured: Check if featured
  • Blog Posts: Select related blog post
  • Display Order: Number for sorting (1, 2, 3, etc.)

Step 3.3: Save Designer Entry

  1. Review all information
  2. Click the Save button
  3. Designer is now available to connect to products

Step 3.4: Repeat for All Designers

Repeat Steps 3.1-3.3 for each designer you want to add.

💡 Pro Tip: Fill in at least Name, Logo, Description, Country, and Designer Collection for each designer to get the best display results.
✅ Checkpoint: You have designer entries ready to connect to products

Part 4: Connect Products to Designers

⏱️ Time Required: 1-2 minutes per product
📅 Frequency: Every time you add/edit a product

Step 4.1: Edit a Product

  1. Go to ProductsAll products
  2. Click on a product to edit

Step 4.2: Find Metafields Section

  1. Scroll down on the product edit page
  2. Look for Metafields section (usually on the right side)
  3. You should see: Designer (or whatever you named it)
If you DON'T see it:
  • The metafield definition wasn't created correctly
  • Go back to Part 2 and verify the setup
  • Make sure you saved the metafield definition

Step 4.3: Select Designer

  1. Click on the Designer dropdown
  2. Select the designer from the list (e.g., "Lulu + Roo")
  3. The dropdown shows all designers you created
If dropdown is empty:
  • You haven't added any designer entries yet
  • Go back to Part 3 and add designers

Step 4.4: Save Product

  1. Click the Save button at the top right
  2. The product is now connected to the designer

Step 4.5: Bulk Assign (Optional)

For assigning many products at once:

  1. Go to ProductsAll products
  2. Click More actionsBulk editor
  3. Select products to edit
  4. Add Designer column
  5. Select designers from the dropdown for each product
  6. Click Save
✅ Checkpoint: Your products are now connected to designers

Part 5: Create Section Files

⏱️ Time Required: 15-20 minutes
📅 Frequency: One-time setup

You'll create 4 section files that display designer information.

Step 5.1: Access Theme Code Editor

  1. Go to Online StoreThemes
  2. Find your current theme
  3. Click ActionsEdit code
  4. Find the Sections folder in the left sidebar

Step 5.2: Create Section Files

For each of the 4 sections below, follow these steps:

Process:

  1. Click Add a new section
  2. Enter the section name (without .liquid extension)
  3. Copy the complete code from the appendices
  4. Paste into the editor
  5. Click Save

Section Files to Create:

File Name Purpose Code Location
designer-info Main designer information display Appendix A
designer-badge Simple designer name badge Appendix B
designer-care Care instructions display Appendix C
designer-size-chart Size chart button Appendix D

Step 5.3: Verify All Sections Created

Look in the Sections folder. You should see:

  • designer-info.liquid
  • designer-badge.liquid
  • designer-care.liquid
  • designer-size-chart.liquid
✅ Checkpoint: All 4 section files are created and saved

Part 6: Add Sections to Product Pages

⏱️ Time Required: 10 minutes
📅 Frequency: One-time setup per product template

Step 6.1: Access Theme Customizer

  1. Go to Online StoreThemes
  2. Click the Customize button
  3. You'll be in the theme customizer

Step 6.2: Navigate to Product Page

  1. At the top of the page, click the page selector dropdown
  2. Select ProductsDefault product
  3. OR navigate to any specific product

Step 6.3: Add Designer Sections

For each section you want to add:

  1. In the left sidebar, scroll to where you want the section
  2. Click Add section button
  3. Scroll through the section list to find:
    • Designer Info
    • Designer Badge
    • Designer Care
    • Designer Size Chart
  4. Click on the section to add it
  5. Drag the section to position it where you want

Step 6.4: Customize Section Settings

Click on each section in the left sidebar to see customization options.

Step 6.5: Preview and Test

  1. Use the preview to see how sections look
  2. Navigate to different products with different designers
  3. Verify correct designer info appears for each product
  4. Test on different screen sizes using device preview
  5. Click the size chart button to test modal

Step 6.6: Save Changes

  1. Click the Save button (top right)
  2. Sections are now live on your product pages
✅ Checkpoint: Designer sections are displaying on product pages

🔧 Troubleshooting

Issue 1: "Key already exists" Error

Problem: When creating the product metafield, Shopify says the key already exists.

Solution:

  1. Go to SettingsCustom DataProducts
  2. Look for an existing metafield with that key
  3. Option A: Delete the old metafield if not in use
  4. Option B: Choose a different key (e.g., designer_info, product_designer)
  5. IMPORTANT: Write down the key you used!
  6. Update the liquid code to use your exact key
Code Update Required:
If you used custom.designer_info instead of custom.designer, change this line in ALL section files:
{%- if product.metafields.custom.designer.value -%}

TO:

{%- if product.metafields.custom.designer_info.value -%}

Issue 2: Sections Don't Appear in Customizer

Problem: After creating section files, they don't show up in "Add section" list.

Solutions:

  1. Refresh the Customizer: Close the tab and reopen Customize
  2. Check File Names: Verify sections are named exactly:
    • designer-info (not designer-info.liquid)
    • No typos in names
  3. Check Code: Make sure you pasted the complete code, including {% schema %} section
  4. Wait: Sometimes it takes 30 seconds to appear

Issue 3: No Designer Info Displaying on Product Page

Problem: Sections are added but show nothing on product page.

Diagnosis Steps:

Step A: Verify Product Has Designer Assigned

  1. Edit the product
  2. Scroll to Metafields
  3. Is the Designer field filled? If NO → assign a designer

Step B: Verify Metafield Key Matches Code

  1. Go to SettingsCustom DataProducts
  2. Click on the Designer metafield
  3. Check the Namespace and key (e.g., custom.designer)
  4. Open designer-info.liquid in the code editor
  5. Find this line and verify it matches your key

Step C: Check Designer Entry Has Data

  1. Go to ContentMetaobjectsDesigners
  2. Click on the designer
  3. Verify fields are filled (especially Name, Logo, Description)

🔄 Maintenance

Adding New Designers

Frequency: As needed

  1. Go to ContentMetaobjectsDesigners
  2. Click Add entry
  3. Fill in all fields
  4. Click Save
  5. Designer is now available to assign to products

Updating Existing Designer Info

Frequency: As needed

  1. Go to ContentMetaobjectsDesigners
  2. Click on the designer to edit
  3. Update any fields
  4. Click Save
  5. Changes appear immediately on all products using that designer

Bulk Assigning Designers to Products

When: Adding many products at once

  1. Go to ProductsAll products
  2. Select products (use filters to find products by a specific designer)
  3. Click More actionsBulk editor
  4. Add column: Designer
  5. Select a designer from the dropdown for each product
  6. Click Save

📎 Appendices - Section Code

Appendix A: designer-info.liquid

Purpose: Main designer information display with full details

File Name: designer-info

{% comment %} Designer Information Display Section Metafield: product.metafields.custom.designer {% endcomment %} {%- if product.metafields.custom.designer.value -%} {%- assign designer = product.metafields.custom.designer.value -%} <div class="designer-info-section"> <!-- Full designer info display code --> <!-- See complete code in the markdown file --> </div> {%- endif -%} {% schema %} { "name": "Designer Info", "tag": "section", "settings": [...] } {% endschema %}
📝 Note: The complete code for all sections is too long to display in full here. Please refer to the original markdown document or contact support for the full section code files.

Appendix B: designer-badge.liquid

Purpose: Simple designer name badge

File Name: designer-badge

Appendix C: designer-care.liquid

Purpose: Care instructions display

File Name: designer-care

Appendix D: designer-size-chart.liquid

Purpose: Size chart button with modal

File Name: designer-size-chart

Document Version: 1.0 | Last Updated: November 20, 2025

Veronica Jeans

Veronica Jeans

eCommerce Strategist | Shopify Expert | 7-Figure Business Coach

I have integrated my extensive knowledge in the field of eCommerce and Shopify, along with my international financial expertise, to offer up a playbook for generating income online.