How To Setup Shopify Designers or Brands With Metaobject & Metafields - SOP
Store: Itsy Bitsy Boutique
Theme: Someone You Know Xclusive
Purpose: Display designer information dynamically on product pages
Last Updated: November 20, 2025
📋 Table of Contents
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
📅 Frequency: One-time setup
Step 1.1: Access Metaobjects
- Log into Shopify Admin
- Go to Settings (bottom left corner)
- Click Custom Data
- Click Metaobjects tab at top
- 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) |
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
- Review all fields
- Click Save button (top right)
- You should see confirmation: "Metaobject definition created"
Part 2: Create Product Metafield Definition
📅 Frequency: One-time setup
Step 2.1: Access Product Custom Data
- Go to Settings → Custom Data
- Click Products tab at top
- 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
- Click Select namespace and key
- 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
- Click Add to confirm
Final result should show:
OR whatever alternative key you chose
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
- Review all settings
- Click Save button
- You should see confirmation: "Metafield definition created"
Part 3: Add Designer Entries
📅 Frequency: As needed when adding new designers
Step 3.1: Access Metaobject Entries
- Go to Content → Metaobjects
- Click on Designers from the list
- 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
- Review all information
- Click the Save button
- 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.
Part 4: Connect Products to Designers
📅 Frequency: Every time you add/edit a product
Step 4.1: Edit a Product
- Go to Products → All products
- Click on a product to edit
Step 4.2: Find Metafields Section
- Scroll down on the product edit page
- Look for Metafields section (usually on the right side)
- You should see: Designer (or whatever you named 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
- Click on the Designer dropdown
- Select the designer from the list (e.g., "Lulu + Roo")
- The dropdown shows all designers you created
- You haven't added any designer entries yet
- Go back to Part 3 and add designers
Step 4.4: Save Product
- Click the Save button at the top right
- The product is now connected to the designer
Step 4.5: Bulk Assign (Optional)
For assigning many products at once:
- Go to Products → All products
- Click More actions → Bulk editor
- Select products to edit
- Add Designer column
- Select designers from the dropdown for each product
- Click Save
Part 5: Create Section Files
📅 Frequency: One-time setup
You'll create 4 section files that display designer information.
Step 5.1: Access Theme Code Editor
- Go to Online Store → Themes
- Find your current theme
- Click Actions → Edit code
- 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:
- Click Add a new section
- Enter the section name (without .liquid extension)
- Copy the complete code from the appendices
- Paste into the editor
- 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
Part 6: Add Sections to Product Pages
📅 Frequency: One-time setup per product template
Step 6.1: Access Theme Customizer
- Go to Online Store → Themes
- Click the Customize button
- You'll be in the theme customizer
Step 6.2: Navigate to Product Page
- At the top of the page, click the page selector dropdown
- Select Products → Default product
- OR navigate to any specific product
Step 6.3: Add Designer Sections
For each section you want to add:
- In the left sidebar, scroll to where you want the section
- Click Add section button
- Scroll through the section list to find:
- Designer Info
- Designer Badge
- Designer Care
- Designer Size Chart
- Click on the section to add it
- 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
- Use the preview to see how sections look
- Navigate to different products with different designers
- Verify correct designer info appears for each product
- Test on different screen sizes using device preview
- Click the size chart button to test modal
Step 6.6: Save Changes
- Click the Save button (top right)
- Sections are now live on your product pages
🔧 Troubleshooting
Issue 1: "Key already exists" Error
Problem: When creating the product metafield, Shopify says the key already exists.
Solution:
- Go to Settings → Custom Data → Products
- Look for an existing metafield with that key
- Option A: Delete the old metafield if not in use
- Option B: Choose a different key (e.g., designer_info, product_designer)
- IMPORTANT: Write down the key you used!
- Update the liquid code to use your exact key
If you used custom.designer_info instead of custom.designer, change this line in ALL section files:
TO:
Issue 2: Sections Don't Appear in Customizer
Problem: After creating section files, they don't show up in "Add section" list.
Solutions:
- Refresh the Customizer: Close the tab and reopen Customize
-
Check File Names: Verify sections are named exactly:
- designer-info (not designer-info.liquid)
- No typos in names
- Check Code: Make sure you pasted the complete code, including {% schema %} section
- 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
- Edit the product
- Scroll to Metafields
- Is the Designer field filled? If NO → assign a designer
Step B: Verify Metafield Key Matches Code
- Go to Settings → Custom Data → Products
- Click on the Designer metafield
- Check the Namespace and key (e.g., custom.designer)
- Open designer-info.liquid in the code editor
- Find this line and verify it matches your key
Step C: Check Designer Entry Has Data
- Go to Content → Metaobjects → Designers
- Click on the designer
- Verify fields are filled (especially Name, Logo, Description)
🔄 Maintenance
Adding New Designers
Frequency: As needed
- Go to Content → Metaobjects → Designers
- Click Add entry
- Fill in all fields
- Click Save
- Designer is now available to assign to products
Updating Existing Designer Info
Frequency: As needed
- Go to Content → Metaobjects → Designers
- Click on the designer to edit
- Update any fields
- Click Save
- Changes appear immediately on all products using that designer
Bulk Assigning Designers to Products
When: Adding many products at once
- Go to Products → All products
- Select products (use filters to find products by a specific designer)
- Click More actions → Bulk editor
- Add column: Designer
- Select a designer from the dropdown for each product
- Click Save
📎 Appendices - Section Code
Appendix A: designer-info.liquid
Purpose: Main designer information display with full details
File Name: designer-info
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
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.