Set up Tress's metafields

Tress's features read three kinds of data, none of which needs an app:

• Product and variant metafields in the custom namespace (the one Shopify admin uses when you create a definition): the hair details, care steps, install weights and labels, and the card meta line.
• Theme settings in Theme settings › Hair, lashes and nails: which of your option names become a length scale, texture chips, a glossary, nail chips and sizes, and the short text maps and tables those features read (landmarks, texture pictures, definitions, cap sizes, tip numbers and widths), plus the sizing kit product.
• Section settings for the install builder (its collections, the most bundles and the deal line) and product tags for three badges.

Tress doesn't use metaobjects, so there is nothing to set up under Content › Metaobjects except, if you like, the swatches of your texture option (below). You only need the data for the features you use: every feature hides when its data is empty, or falls back to its block or theme settings, so nothing breaks while you fill it in.

In Shopify admin, metafield definitions live under Settings › Custom data (called Metafields and metaobjects in newer versions of the admin).

The metafields Tress reads

Two more metafields are filled in by review apps, not by you: reviews.rating and reviews.rating_count give the stars on cards and "4.9 · 186 reviews" in the Product metadata block. And a Spec row block (chapter 11) can show any other product metafield you create, such as custom.band ("Cotton band") for lashes.

These product tags add badges (capitals don't matter):

Step 1: create the product metafield definitions

In admin, go to Settings › Custom data › Products and click Add definition for each metafield you need:

1. Type the Name (yours to choose; it's what you see when you edit a product).
2. Check the Namespace and key under it and change it to exactly the key in the table above. Shopify suggests custom. plus the name, so "Lace" gives custom.lace, but "Weight per bundle" would give custom.weight_per_bundle and "Can be coloured" custom.can_be_coloured, which the theme won't find. Keys are case-sensitive.
3. Click Select type and choose the type in the table:
   • Hair origin, Grade, Lace, Cap size, Density, Lifespan, Texture, Short name and Card meta line: Single line text, One value (not a list).
   • Weight per bundle and Wears: Integer, One value. Not Decimal, and not Weight (Shopify's measurement type): Tress expects a whole number, in grams for the weight.
   • Colouring: True or false.
   • Care: Rich text.
4. Save.

Step 2: add the variant weight

Bundles are sold by length, and a 26 in bundle weighs more than a 12 in one. To give each length its own weight, go to Settings › Custom data › Variants, click Add definition and create Weight per bundle again with exactly the same key, custom.weight_grams, type Integer, One value. A variant with a weight uses it; a variant without one uses the product's. If every length weighs the same (100 g bundles), the product definition alone is enough.

Step 3: fill in your products

Open a product in admin and scroll to Metafields: every product definition you created is listed there. For a variant's weight, click the variant and scroll to its Metafields.

• Single line text: type the value as you want shoppers to read it: "150%", "HD lace, 13×4, free part", "12+ months with care". Write lace sizes with a multiplication sign (13×4) and lengths as "18 in".

• Weight per bundle and Wears: the number only, such as 100 or 20.

• Colouring: choose True or False, or leave it empty for no row.

• Care: use the rich text editor's numbered list, one step per item, and start each step with a short sentence in bold. For example:

  1. Detangle before you wash. Wide-tooth comb, from the ends up.
  2. Wash cool, condition well. Sulphate-free shampoo every 7 to 10 days.
  3. Sleep in silk. Wrap it in the bonnet we send with every install.

  A numbered list shows each step in a numbered capsule, with the bold sentence as its title line.

To fill many products at once, use Bulk edit from the products list and add the metafield columns. Add the best-seller, new and most-loved tags in the product's Tags field.

The settings the features read

Everything below is in Theme settings › Hair, lashes and nails. Option names are matched without regard to capitals or the spaces around them, separated by commas. An option is only turned into a scale or chips when every value fits, so check your values if an option still shows as tiles.

Length landmarks

The default:

10 in: Chin
14 in: Shoulder
18 in: Armpit
22 in: Mid-back
26 in: Waist
30 in: Hip

A stop on the length scale whose length equals a landmark's shows its name beside it ("18 in · 46 cm · Armpit"). You can write a landmark in cm (35 cm: Shoulder); it's matched by its length in inches, rounded. The first six lines also place the six marks on the figure, in order: chin, shoulder, armpit, mid-back, waist and hip. So keep six lines, in order from shortest to longest, and change the numbers to where those points fall for your hair (on a taller model, 16 in: Shoulder). Add more lines after the sixth for extra names on the scale (40 in: Knee); they don't move the figure. Blank lines and lines without a colon are skipped.

Texture images

Straight: straight-swatch.jpg
Body wave: body-wave-swatch.jpg
Deep wave: deep-wave-swatch.jpg
Kinky curly: kinky-curly-swatch.jpg

Upload each picture in Content › Files (a close-up of the hair, upright, works best: the chip is a tall capsule), then type the file's name exactly as Files shows it, extension included, after the texture's name. The texture's name is matched to your option value without regard to capitals: an exact match first, then the longest name the value contains, so "Body wave" also covers a value called "Body wave 100% raw". A Shopify swatch image on the option value (below) wins over this list.

Glossary

The default:

HD lace: A thin, fine lace that melts into most skin tones. Handle it gently.
Transparent lace: A sturdier, see-through lace for light to medium skin tones.
Swiss lace: A soft, durable light-brown lace that outlasts HD lace.
130%: Natural fullness, like most people's own hair.
150%: Fuller than natural, the most asked-for glam finish.
180%: Extra full, for big volume and long lengths.
10A: Hair from one donor, cuticles aligned and never chemically processed.
Raw: Unprocessed hair cut from one donor, cuticles intact.
Small: Fits a head of 52 to 54.5 cm around.
Medium: Fits 55 to 57 cm around, the most common cap size.
Large: Fits 57.5 to 60 cm around.

Each term is matched to the values of the options in Options with a glossary, the same way as texture names: exactly first, then the longest term the value contains ("HD lace 13×4" finds "HD lace"). The glossary dialog lists only the option's values that have a definition, in the option's order. Write one short, plain sentence per term, and only claims that are true of your hair.

Cap size table

The default:

Small | 52–54.5 cm
Medium | 55–57 cm
Large | 57.5–60 cm

One size per line, a bar (|) between the size and the range. Write the range with an en dash or a hyphen (55-57 cm works too), in cm or in (21.5–22.5 in). Name the sizes exactly as the values of your Cap size option ("Medium", not "M"), so the cap guide's Choose Medium button can pick the matching value.

Tip numbers per size

The default:

XS: 5,8,7,8,10
S: 4,7,6,7,9
M: 3,6,5,6,9
L: 2,5,4,5,8
XL: 1,4,3,4,7

One line per standard size: the size exactly as it appears in your Size option, a colon, then five tip numbers from thumb to pinky, separated by commas. A line with more or fewer than five numbers is ignored, and a size with no line shows no tips card.

Tip widths

The default lists sizes 0 to 11, from 18 mm down to 7 mm, one per line:

0: 18 mm
1: 17 mm
2: 16 mm
3: 15 mm
...
11: 7 mm

They show in the measuring guide as "Size 3 · 15 mm", in two columns. Use the widths of the tips you actually ship.

Texture swatches from Shopify

Instead of (or as well as) the Texture images list, you can give each value of your texture option a Shopify swatch image: Tress uses it first, on the product page and in the Texture filter. (The install builder's texture chips are labelled by product, not by option value, so they use the Texture images list or the drawn texture, else the bundle's own photo.) Shopify swatches come from connecting an option to a category metafield that supports swatches, such as Color:

1. Give the product a Category in admin that offers the attribute.
2. In the product's Variants section, edit the texture option and connect it to that category metafield, choosing or creating an entry for each value (Straight, Body wave and so on).
3. Open each entry (from the option, or under Content › Metaobjects) and add a swatch image of the texture.

Keep the option's name, as the product shows it, in Texture option names: if connecting renames the option (to "Color", say), add that name to the list, or the chips won't appear. A value with only a swatch color and no image falls through to the Texture images list, then to the drawn texture.

The install builder's settings

The install builder reads its own section's settings, not metafields (chapter 9 has them all). The ones to set before it can sell:

• Bundles: a collection with one product per texture, each with a Length option (named in Length option names). The first 8 products are shown, as texture chips labelled with each product's custom.texture (else its title).
• Closures and frontals: optional, a collection of your closures and frontals. The first 4 are shown.
• Most bundles (4, 2 to 6) and Fewest bundles (2, 1 to 4): how many bundles one install can hold.
• Deal line ("3 bundles and a closure: 15% off at checkout"), Bundles for the deal (3, 0 to 6; 0 hides the line) and Deal needs a closure or frontal (on): when the deal line counts as met.
• Each bundle variant's (or product's) custom.weight_grams, for the total weight, and each closure's custom.short_name, for the install's label.

The deal line is only words. You create the discount itself in Shopify admin as an automatic discount, so it applies at checkout without a code:

1. Go to Discounts › Create discount and choose Amount off products.
2. Set Method to Automatic discount and give it a Title shoppers will see at checkout ("Install deal").
3. Set the Value to a Percentage (15) and Applies to to Specific collections: your Bundles and Closures and frontals collections.
4. Under Minimum purchase requirements, choose Minimum quantity of items and type 4 (three bundles and a closure).
5. Set the dates and Save.

Shopify applies the discount by its own rules: this one also takes 15% off four bundles without a closure, because it counts items, not what they are. Word the deal line to match the discount you actually create, and set the same deal line in the Cart drawer and Cart sections (chapter 12), which show it again in the bag.

The sizing kit product

Create your sizing kit as an ordinary product (Lacquer's home page promotes one with 12 clear tips in sizes 0 to 11), then choose it in Theme settings › Hair, lashes and nails › Sizing kit product. Every press-on set's size option then gets a "Not sure of your size?" row with the kit's photo, title, price and Sizing kit note, and an Add kit button that puts it in the bag without leaving the page. A kit with options links to its own page instead. Leave the setting empty for no row; the "How to measure your nails" link stays either way.

The instalments message

The Price block's Show Shop Pay Installments (on) prints Shopify's own instalments message under the price, with Shopify's "Learn more" link. It appears only when Shop Pay Installments is enabled on your store (in Settings › Payments, where Shopify offers it); there is nothing to set up in the theme. Tress never prints a "pay in 4" line of its own: the presets' "Pay in 4 available" announcement and "Pay in 4 at checkout" hero tick are demo words, so keep them only if you offer a pay-later method at checkout.

What shows without the data

In the theme editor, features with no data show a sample tagged Sample so you can see the design: sample rows and pills in Hair details, the sample length scale, texture chips, lace glossary and nail sizer in the variant picker (chapter 6), and four drawn textures with working steppers in the install builder. Shoppers never see them.