Cascading dropdowns let a child dropdown show only the options that belong to the visitor's selection in a parent dropdown — for example, picking a country first, then seeing only that country's cities. This article explains how the parent link and filter keys work.
Note: Cascading dropdowns are a Professional plan feature.
How it works
A cascading dropdown relies on two pieces:
- A parent dropdown that the visitor chooses from first.
- A filter key on each child option that matches a parent option, so the child list narrows to just the matching options.
When the visitor picks a parent value, the child dropdown shows only the options whose filter key matches that parent selection. Changing the parent resets the child's selection.
Setting up the child options
Each child option needs a filterKey that points back to the parent it belongs to. The easiest way to set this up is by CSV import, because the CSV can include a filterKey column alongside label and value.
- Build your parent dropdown and its options as usual.
- For the child dropdown, prepare a CSV with three columns:
label,value, andfilterKey. SetfilterKeyon each row to the parent value (or parent option) it should appear under. - In the child dropdown's Table View, click Import CSV and select your file. The imported options carry their filter keys.
In Table View, options for a cascading dropdown show a Parent column so you can see each option's filter key. See Importing options from CSV.
Requirements and gotchas
- Every child option must have a filter key. Options with a blank filter key won't appear under any parent.
- The parent dropdown must have a selection before the child shows any options — until then, the child list is empty.
- The child's filter key values must match the parent's values exactly.
If a cascading dropdown shows no options, check the parent has a value set and that the child options' filter keys match. See Cascading dropdown shows no options.