intermediate

Survey Script Mode

Paste a survey script, check the preview, and save it into the builder

8 min readUpdated November 10, 2026

Survey Script Mode

Script Mode is a text editor for the survey. You paste a script, the preview updates, and Save Script writes that structure into the builder.

Open it

On the survey builder top bar, the two icon buttons are Visual Mode and Script Mode. Hover a button to see the name.

Those buttons show up on plans that include Script Mode. If they are not on the bar, Script Mode is not on your plan.

Tools stays unavailable while Script Mode is open. To change the title or description in the usual fields, go back to Visual Mode first. If you still have script changes waiting, the banner says Save or discard your applied script changes before returning to Visual Mode.

Paste, preview, save

The editor is labeled Script.

1

Paste your script. To replace everything already in the editor, select all of the text first, then paste.

2

A valid script updates the preview on its own. There is no separate Apply step.

3

Click Save Script.

Discard puts the editor back to the last save. It is available once the script differs from that save.

If the script has a problem, a card titled Script Mode needs attention lists the lines. Save Script stays off until that list is clear. After a valid change that you have not stored yet, the card reads Applied changes are pending save.

What a save changes

Saving replaces sections, questions, choices, and logic.

These stay as they were:

  • Look and feel
  • Quotas
  • Translations
  • End screens
  • Library files

The script does not upload images or video. A question that keeps the same number and the same type also keeps settings the script never mentions, including media already on that question. For a clean import, start from an empty survey so old questions are not merged in.

Line rules

Start with the survey lines, then a section, then questions.

survey title: Brand check
survey visibility: private

section: Main

question: Q1 | single_choice | required
text: Which brand do you use most?
option: Brand A
option: Brand B | end_survey screened_out
option: None of these

question: Q2 | text | optional
text: Why that brand?
  • survey title: is the survey name.
  • survey visibility: is private or public.
  • section: names the section. A question has to sit under a section.
  • A question line is question: Q1 | single_choice | required. The middle field is the type. The last field is required or optional. Put the wording respondents see on the next line, text:.
  • option: is one choice. End-survey logic sits on that option, after a pipe: option: Brand B | end_survey screened_out.
  • screened_out is the Screened Out screen. quota_full is Quota Full. complete is Early Complete.
  • Use straight quotes in logic values, as in "Yes". Curly quotes will not match.
  • Keep | out of titles, section names, and option labels. The script uses | to separate fields.
  • A multi-line block opens on a line that ends with <<< and closes with >>> on its own line. Custom question code uses custom html <<<, custom css <<<, or custom js <<<. If the closer is missing, the attention card says the block is missing a closing >>>.

An unknown question type is named in Script Mode needs attention, with the types Script Mode accepts.

Number selected (count)

For Multiple Choice (and multi-select Autosuggest) logic, Script Mode can test how many options were selected — not which option codes. Write count after the question number:

logic: show when Q1 count < 3
logic: show when Q1 count between 1..3

Supported forms:

  • Q1 count = 2
  • Q1 count != 0
  • Q1 count > 3
  • Q1 count < 3
  • Q1 count >= 2
  • Q1 count <= 5
  • Q1 count between 1..3

Same idea as the number selected operators in Visual Mode. Unanswered counts as 0. See Survey Logic & Branching.

Related

Was this article helpful?