Skip to content

Expressions Reference ​

The Expressions page indexes every logical expression in the form — named and unnamed — with where it is used and whether it is still needed. It is an Advanced Mode tool, opened from the Build drawer.

Expressions are edited in the item's logic or visibility pane. This page is the form-level audit: it does not contain a separate expression editor.

Rows and columns ​

ColumnWhat it shows
NameThe shared name, or Unnamed. Named expressions carry a Shared badge.
ExpressionA readable preview that uses question and choice labels instead of internal keys.
Used byThe number of items referencing the expression.
StatusUsed, Unused, Deleted ref, or Used · deleted ref.

The heading badge counts unused expressions. Header filters narrow by name, expression text, item label and status.

Status meanings ​

StatusMeaningWhat to do
UsedAt least one active item references it.Leave it; edit through the item if needed.
UnusedNo active item references it.Delete it if it is no longer planned, or keep it while drafting.
Deleted refOnly a soft-deleted item references it.Restore the item or remove the reference before deleting.
Used · deleted refActive and soft-deleted items both reference it.Resolve the deleted reference; active use still applies.

Naming and sharing ​

Whether an expression is offered in the Select an existing expression dropdown depends on its Name:

  • Naming an expression marks it Shared and makes it selectable across the form.
  • Renaming changes the label in the picker; existing links keep working.
  • Clearing the name unshares it: it is no longer offered to new items, but the expression and every item already using it continue to work.

Shared expressions behave like shared options: one definition, many users. A change to the expression affects every item that references it, so review those items after editing.

Detail pane ​

Expand a row to see:

  • Used by — each question, section, page or survey text that references the expression, with the logic slot it controls (Hidden, Required, Read-only or Invalid).
  • Open in compose — jumps to that item.
  • Name and Description — editable in the expanded row.
  • Expression — a read-only preview.
  • Delete expression — available only when the deletion rules allow it.

Deleting an expression ​

Deletion is allowed only when:

  • no active item uses the expression, and
  • no soft-deleted item still references it.

If a deleted item still points at it, the status shows Deleted ref and deletion is blocked. Restore the item, or remove the reference, so restoring it later cannot leave broken logic.

A deleted expression is recoverable from Build → Restore.

When to use this page ​

  • Auditing logic before a build, when a form has grown over time.
  • Finding expressions left behind after restructuring.
  • Renaming a shared condition so colleagues recognize it.
  • Confirming that deleting an item did not leave only a deleted reference behind.