UserHero Docs
Custom Fields

Dependent Fields

Show fields conditionally and filter dropdown options based on other fields

Dependent Fields

Two settings let you create relationships between custom fields:

  • Conditional Display — a field is only shown when a specific dropdown field has a particular value
  • Cascade Options — a dropdown field's available options are filtered based on the current value of another dropdown field

Both settings are configured per field in Project Settings > Custom Fields.

Conditional Display

When Conditional Display is enabled on a field, that field is hidden until a specified trigger field equals a specified value.

How to configure

  1. Open the field you want to make conditional (or create a new one)
  2. Enable the Conditional Display toggle
  3. Under Show when field, choose any select-type field in the project
  4. Under equals, choose the exact option value that should reveal this field
  5. Save the field

A blue Conditional badge appears on the field in the field list to indicate the dependency is active.

Behavior

SituationResult
Trigger field has no valueConditional field is hidden
Trigger field equals the required valueConditional field appears
Trigger field changes to a different valueConditional field hides and its current value is cleared
Trigger field is itself hiddenConditional field is also hidden, regardless of its value

The last rule means conditions are evaluated recursively. If field B depends on field A, and field C depends on field B, then hiding A automatically hides both B and C and clears their values.

Nesting limit

Chains can be up to 3 levels deep. The admin interface blocks saving a configuration that would create a 4th level.

AllowedExample
3 levelsCategory → Subcategory → Issue Type
4+ levelsCategory → Subcategory → Issue Type → Detail — blocked

Circular dependencies (field A depends on field B, field B depends on field A) are also blocked.


Cascade Options

When Cascade Options is enabled on a select field, the available options in that dropdown change based on the current value of a parent select field.

How to configure

  1. Open a select-type field
  2. Enable the Cascade Options toggle
  3. Under Parent field, choose any other select-type field in the project
  4. Under Option mapping, for each value of the parent field, check the options that should be available
  5. Save the field

A purple Cascades badge appears on the field in the field list.

Behavior

SituationResult
Parent field has no valueAll options are available (full list shown)
Parent field has a valueOnly the mapped options for that value are shown
Parent value changesOptions are immediately updated; if the current selection is no longer available, it is cleared

Combining with Conditional Display

A field can have both Conditional Display and Cascade Options enabled at the same time. In that case, visibility takes priority: the field is hidden when the trigger condition is not met, and the cascade filtering applies only when the field is visible.


Worked Example

Scenario: A support team wants users to pick a category first, then a subcategory relevant to that category, then an issue type if the subcategory is "Invoice".

Fields:

FieldTypeConfiguration
CategoryDropdownOptions: Billing, Technical, Account
SubcategoryDropdownOptions: Invoice, Refund, Bug, Feature, Login, Password
Issue TypeDropdownOptions: Urgent, Normal, Low

Dependencies:

FieldSettingRule
SubcategoryConditional DisplayShow when Category = Billing
SubcategoryCascade OptionsParent: Category → Billing shows Invoice, Refund · Technical shows Bug, Feature · Account shows Login, Password
Issue TypeConditional DisplayShow when Subcategory = Invoice

What the user sees:

  1. Category dropdown — always visible
  2. User picks Billing → Subcategory appears showing only Invoice and Refund
  3. User picks Invoice → Issue Type appears showing Urgent, Normal, Low
  4. User changes Category to Technical → Subcategory hides (and clears), Issue Type also hides (and clears)

Next Steps

On this page