Conditional logic

Conditional logic shows a field only when other fields have certain values. It runs on the edit screen as the editor types; it does not change what is stored or what your theme prints.

Set it up

1. Open the field's Advanced options and go to the Conditional logic tab.
2. Turn on Enable conditional logic. (While it is off the tab says When enabled, this field is shown or hidden based on the values of other fields in the same group.)
3. Click Add condition. A condition has three parts:

4. Choose how several conditions combine: Match: and / or of the following conditions.
5. • and: all conditions must be true.
   • or: at least one must be true.
5. Save the group.

If the group has no other fields the tab says No other fields are defined in this group. Add more fields to use conditional logic. At most 20 conditions are kept per field.

Operators

Fields stored as JSON (Checkbox list, relationships, Group, Repeater, Gallery, ...) only offer Has value and Is empty.

What to type in Value:

Which fields can I use?

Conditions only see sibling fields: fields on the same level of the same group. Inside a Group or Repeater a condition looks at the other sub-fields of the same group value or the same repeater row. Conditions cannot look at fields in another group, or reach from a sub-field to a root field.

If a condition names a field that no longer exists, that condition counts as true.

What happens to hidden fields

The server evaluates the same conditions (for the required-field check after saving), so a required field that is hidden at save time does not trigger Saved, but these required fields are empty.

Example

A "Product details" group where Sale price only appears when On sale is ticked:

1. Add a True / false field on_sale labeled On sale.
2. Add a Number field sale_price.
3. On sale_price: enable conditional logic, add the condition On sale · Equals · 1.

Through the REST API the same condition looks like:

{
  "key": "sale_price", "label": "Sale price", "type": "number",
  "conditional_logic": {
    "enabled": true,
    "relation": "and",
    "rules": [ { "field_key": "on_sale", "operator": "equals", "value": "1" } ]
  }
}

Troubleshooting