Lookbook metaobjects setup
Create the lookbook_look metaobject, add entries, and connect them to the Lookbook section in Theme Editor.
Use this guide when you want Lookbook content managed in Shopify Content instead of manual section blocks. The Lookbook section supports both modes, so you can migrate gradually.
1. Prerequisites
- Theme version with Lookbook source mode that includes manual blocks and metaobject rendering.
- Admin access to Settings -> Custom data -> Metaobjects and Content -> Metaobjects.
- Storefront access enabled on the lookbook_look definition.
2. Create the definition
Shopify admin: Settings -> Custom data -> Metaobjects -> Add definition.
| Field | Value |
|---|---|
| Name | Lookbook Look |
| Type (API) | lookbook_look |
| Storefront access | Public read enabled |
3. Recommended fields
| Key | Type | Required | Purpose |
|---|---|---|---|
| image | File (single image) | Yes | Hero media for each look card. |
| title | Single line text | Yes | Primary heading shown in overlay/cards. |
| subtitle | Single line text | No | Secondary copy for look context. |
| description | Multi-line text | No | Longer editorial text for overlays. |
| cta_label | Single line text | No | Optional CTA label in overlay. |
| url | URL | No | Destination when tapping the look card. |
| products | Product reference list | No | Shop-the-look products (recommend up to 3). |
| category | Single line text | No | Filter taxonomy option 1. |
| mood | Single line text OR metaobject reference | No | Filter taxonomy option 2. Supports plain text and referenced mood records. |
| service_type | Single line text | No | Filter taxonomy option 3. |
| featured | True/false | No | Pin high-priority looks first when enabled in section settings. |
4. Create entries
Shopify admin: Content -> Metaobjects -> Lookbook Look -> Add entry.
- At minimum fill image and title so the look can render cleanly.
- Populate products to enable shoppable chips and quick add.
- Use consistent taxonomy values (for example hair, skin, ritual) so filters group correctly.
- Set featured true for looks you want prioritized when featured-first ordering is enabled.
5. Wire it in Theme Editor
- Open the page/template containing the Lookbook section.
- Set Source mode to Metaobject lookbook_look entries.
- Set Taxonomy field to Category, Mood, or Service type based on what you filled in entries.
- Optional: enable Shop the look, Quick add, Filters, and Load more.
- Optional: set Featured look ordering to Show featured looks first.
6. Verify behavior
- Lookbook cards render when entries exist and storefront access is enabled.
- Filters only show values present in rendered entries and correctly narrow visible looks.
- Load more reveals additional matched looks without page reload.
- Quick add appears only for available products with a single default variant.
7. Troubleshooting
| Issue | What to check |
|---|---|
| No looks render in metaobject mode | Definition API type must be exactly lookbook_look and storefront access must be enabled. |
| Filters show no useful options | Populate category, mood, or service_type consistently across entries and select the matching taxonomy field in section settings. |
| Quick add missing on product chips | Quick add only shows for available products with a single default variant and when section setting Enable quick add is on. |
| Featured-first ordering has no effect | Set featured=true on one or more entries and set section setting Featured look ordering to featured_first. |
8. Related docs
- Section library for where Lookbook sits in the merchandising stack.
- JavaScript events for analytics signals emitted by lookbook interactions.
Was this page helpful?
Content is maintained by Arcanum Hollow Labs. For internal engineering notes, see the docs/ folder in the monorepo.