Theme & Storefront
The storefront integration surface. Smart filters, sizing chart tabs, and theme-side configuration all live here.
Smart filters
Smart filters are the “Shop By” facets on the storefront — Color, Size, Brand, Fit, Occasion, etc. They read from the tc_core metafields ThreadCloud writes on push.
Configuration
Settings → Theme → Smart Filters tab. You’ll see a list of enabled filters:
| Filter | Reads from | Notes |
|---|---|---|
| Color | tc_core.color_group | Canonical 12-bucket palette |
| Size | Variant size tag | Driven by category’s size scale |
| Brand | vendor (native Shopify) | Multi-select |
| Fit | tc_core.fit_type | Slim / Regular / Classic / Relaxed |
| Occasion | tc_core.occasion | Multi-value support |
| Fabric | tc_core.fiber_primary | Cashmere / Wool / Cotton / etc. |
| Country of Origin | tc_core.coo | Only prestige origins shown |
| Pattern | tc_core.pattern_type | Solid / Stripe / Check / etc. |
| Price | Shopify price | Native |
Each row has an enable toggle and a “configure” button (for things like Color, where you can hide specific buckets).
Re-evaluating filters
When you change a filter’s config (enable/disable, hide a bucket), the storefront updates within ~30 seconds. No theme deploy needed.
Adding a new filter facet
This is a code change. Out of scope for the team — email hello@threadcloud.io to request a new filter.
Sizing chart tabs
Some categories have storefront sizing chart tabs (the _tab1_xxx-sizing-chart tags ThreadCloud stamps on products). These auto-show a sizing chart tab on the product page.
| Category | Tag stamped | Tab shows |
|---|---|---|
| Suits, Suit Jackets | _tab1_suits-jackets-sizing-chart | EU/US chest size chart |
| Dress Shirts | _tab1_dress-shirts-sizing-chart | Collar circumference chart |
| Pants | _tab1_pants-sizing-chart | Waist + inseam chart |
| Footwear | _tab1_shoes-sizing-chart | EU/US/UK shoe chart |
The tabs themselves are theme metaobjects — managed by the Owner in Shopify Admin → Online Store → Themes → Customize. Out of scope for the team.
Storefront preview
The Theme settings page has a Preview Storefront button. Opens the live store in a new tab. Use it to sanity-check after:
- A big legacy enrichment apply
- A new buying season’s first push
- Adding/removing a filter facet
Image variants for smart filter swatches
Color filter shows swatches. The swatch is sourced from:
- The Shopify product’s variant image for that color (preferred), OR
- A hex code mapped to the color group (fallback)
To set up a custom swatch image:
- Shopify Admin → Products → open one variant
- Set the variant image to a clean swatch (200×200px square works best)
- Storefront picks it up automatically
Common mistakes
tc_core.pattern_type set, the filter shows but lists almost nothing. Run Legacy Enrichment first.category-SUIT, the product drops out of the “Suits” filter. Always edit in ThreadCloud, never in Shopify Admin.Next steps
- Legacy Enrichment — populate metafields for the filters to read
- Settings → AI & Models — control which colour buckets / pattern values get extracted