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
- 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) |
⚠️ 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
- Review all fields
- Click Save button (top right)
- 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
- 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
⚠️ CRITICAL STEP - READ CAREFULLY
- 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:
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
- Review all settings
- Click Save button
- 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
- 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.
💡 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
- 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)
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
- Click on the Designer dropdown
- Select the designer from the list (e.g., "Lulu + Roo")
- 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
- 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
✅ 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
- 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
✅ 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
- 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
✅ 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:
- 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
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:
-
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
{% 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