Fragrance finder — Decant docs

The Fragrance finder section asks three questions and ranks your own scents as the shopper taps: which families they like, how loud (Soft, Balanced or Bold), and when they'll wear it (Spring, Summer, Autumn, Winter or Any). A line says "Smoked Vetiver leads at 92%", and the results reorder under it, each with a "92% match" tab. There's no account and no email, and nothing is stored or sent anywhere. It all happens in the page.

Set it up

Choose your scents. Pick a collection in Scents to rank. The presets start on all products. Only products with a custom.family are ranked, so atomisers, gift cards and the set stay out, and "Ranked from 24 scents" counts only what was ranked.
Fill in custom.family, custom.sillage and custom.seasons on those scents. custom.family is what puts a product in the finder. custom.accords helps too (chapter 7).
Match the families. Each line in Families must equal a custom.family value, ignoring capitals. If your products say "Citrus" and the finder says "Fresh", they won't match.

Settings

Setting	Default	What it does
Eyebrow	"Fragrance finder"
Heading	"Three taps to your next scent"
Intro	"Tell us what you like. The list reorders as you go."
Scents to rank		The collection. With none, shoppers see nothing, and you see a sample in the theme editor.
Products to rank	50	12 to 50. The first ones in the collection that have a `custom.family` and can be bought. Sold-out scents are left out.
Families	Fresh, Floral, Woody, Amber, Gourmand	One per line, up to 8. Match them to `custom.family`.
Families a shopper can pick	3	1 to 3
Show how loud	On
Show when you'll wear it	On
Results to show	6	3 to 6
Lowest match to show	40%	30 to 70%. Scents below this don't show.
See all label	"See all matches"
See all link		Blank uses the collection
Background	Deep glass	Deep glass, Panel or Page
Texture	Reeded glass	None or Reeded glass

Products are read in collection order, so if your collection has more than 50 scents, sort it with your best ones first.

How the ranking works

Each question has a weight: family 60, how loud 25, season 15. Only the questions a shopper has answered count, and the score is what the scent earned out of what was possible.

Question	Full marks	Part marks	No marks
Family	`custom.family` is one the shopper chose	An accord named after a chosen family earns its percentage times 0.8, so `Woody:80` earns 64% of the family marks	Neither
How loud	`custom.sillage` is close to the answer: Soft aims at 1.5, Balanced at 2.5, Bold at 3.5	Marks fall away with distance. A scent with no sillage gets half marks.	A sillage far from the answer
Season	`custom.seasons` includes it	A scent with no seasons gets half marks	It has seasons, but not that one

Any counts as not answered. The match is capped at 98%, because a perfume can't be a perfect match on three taps. Ties go to the scent that comes first in the collection, so the same answers always give the same order.

For example, a shopper picks Woody, Balanced and Autumn. A Woody scent with sillage 3 and seasons Autumn and Winter earns all 60 for family, 20 of 25 for how loud and all 15 for season: a 95% match. An Amber scent with Woody:60 and the same sillage and seasons earns about 29, 20 and 15: 64%.

What shoppers see

Before they answer: your first scents in collection order, with no tabs, and "A good place to start."
Nothing close: "Nothing close yet. Try another family, or see everything." with a link.
At the limit: the other family chips stop responding, and a line says why: "Three is the most. Take one off to change."
On a phone: the results line rides along at the bottom of the section while the questions are in view, with a link that jumps down to the results.
Under the results: "Ranked from 24 scents in this shop." with your See all link.

If nothing in the collection has a custom.family yet, shoppers don't see the section, and the theme editor shows the sample and says why.