Skip to main content

Ending Screens

A regular form has one Thank You screen. Ending screens let you have many — and pick which one to show based on conditions evaluated against your form's variables. This is the engine behind quizzes, assessments, lead-qualifying outcomes, and segmented thank-you experiences.

How Ending Screens Are Picked

When the visitor submits, the system:

  1. Computes every variable's final value (from variable operations).
  2. Evaluates each ending screen's conditions, in order.
  3. Shows the first ending screen whose conditions all pass.
  4. If no ending screen has conditions that match, the last ending screen acts as the catch-all default.

If you don't define any ending screens, the form's regular Thank You screen renders (using the form-level Success Message or the Thank You screen title).

Each Ending Screen

SettingWhat It Does
TitleThe big headline (e.g. Great job! or Try again)
DescriptionSubtitle / paragraph below the title
Button TextOptional button label
Button URLOptional URL the button links to
Show ScoreToggle — when on, displays "Your score: N" with the score variable's value
Show Reload ButtonAdds a "Take it again" reload button
Show Social ShareAdds share buttons (Twitter, Facebook, LinkedIn)
Redirect URLAuto-redirect to this URL after a brief delay
MediaImage / video / GIF shown on the ending screen
ConditionsOne or more conditions that must all pass (see below)

Conditions

A condition is <variable> <operator> <value>. Each condition has:

FieldWhat It Does
VariableWhich variable to test
Operatorequals, not_equals, greater_than, less_than, is_empty, is_not_empty
ValueThe reference value (number for numeric variables, string for text)

Add multiple conditions and they're AND-ed together — every condition must pass for this ending to be picked.

To get OR logic, configure separate ending screens that each have a single condition — the first one whose conditions pass wins, so you effectively get OR'd selection across endings.

Worked Example: 3-Tier Quiz Result

Goal: A quiz with score variable, three outcome screens.

Score RangeTitleDescription
40+Expert!You're in the top tier — here's a discount code…
20–39Good work!Solid result. Want to learn more?
0–19Try againBetter luck next time. Brush up on…

Endings configuration (in order):

#TitleConditionsShow Score
1Expert!score greater_than 39on
2Good work!score greater_than 19on
3Try again(no conditions — fallback)on

When the visitor submits with score = 50, ending #1 matches and renders. When score = 30, ending #1 fails (30 not > 39), ending #2 matches (30 > 19), renders. When score = 5, only ending #3 matches (no conditions — always passes).

Order matters

Endings are evaluated top-to-bottom, first-match-wins. Put the most-specific conditions first and the catch-all (no conditions) last.

Adding Ending Screens

In the conversational form builder, open the Endings panel (right side, when no screen is selected).

  1. Click + Add Ending Screen.
  2. Set the title and description.
  3. (Optional) Toggle Show Score to display the variable.
  4. Click + Add Condition to add the rules that determine when this ending shows.
  5. Reorder endings via drag (most-specific first).
  6. Save.

When Ending Screens Override the Thank You Screen

If any ending screen's conditions match, the matched ending replaces the Thank You screen entirely. The form-level Success Message in Form Settings is not shown — the ending's title is shown instead.

If no ending screen's conditions match (and no catch-all exists), the Thank You screen renders as the fallback.

Show Score Detail

When Show Score is on, the ending screen renders an extra line below the description:

Your score: N

The N is the value of the form's score variable (the variable with type: 'score', or the first variable if none is typed as score).

If you have multiple variables, only the score variable is auto-displayed. To show others (text variables, multiple numbers), you'd need to template their values into the title or description manually — currently the system displays only the score.

Buttons & Redirects on Endings

Two ways to direct the visitor after they see the ending:

Button URL

Set Button Text and Button URL on the ending screen. The visitor sees a button below the description. Clicking it opens the URL in the same tab.

Auto-Redirect

Set Redirect URL to navigate automatically. After ~800ms (giving the visitor a chance to read the title), the page navigates.

You can use both — the button is for "take action" CTAs, the redirect for "you're done, here's where to go next."


Next Steps