Skip to main content

Questions, Welcome and Thank you

This guide describes the survey editor for a website survey: the sidebar, the Welcome and Thank you messages, and the generic question editor that's common to all question types. The specifics of each individual question type are documented in their own pages (see Question types below).

To open the editor, create a survey or click on an existing one from the source's Surveys page.

Editor layout

The editor is a full-screen workspace with three areas:

  • Top header (always visible) — back button, the survey name (auto-generated as New told, editable inline), three top-level tabs Content / Publish / Results, and a Preview button on the right
  • Sub-tabs under Content — Questions (this guide) and Customization (separate page)
  • Sidebar (left) and main editing area (right) under the Questions sub-tab

The left sidebar lists all the items in your survey, top to bottom. It contains:

  • The language selector with a Translate button (disabled until you have at least 2 languages)
  • Welcome message — always present, disabled by default
  • The list of questions in the order they appear in the survey
  • A + Add a question button between the questions and Thank you
  • Thank you message — always present, disabled by default

Click on any item to open its editor in the main area.

Reordering questions

Each question in the sidebar has a drag handle on its right side. Drag a question up or down to reorder it. Welcome message and Thank you message can't be reordered — they're always first and last respectively.

Adding a question

Click the + Add a question button to open the question type picker in the main area. Pick a type and click Insert to add it to your survey. The newly created question is inserted between the previously selected question and the Thank you message.

You can also add a question while editing another one — when you click Add a question, the type picker opens above your current question, which stays visible and editable.

Welcome message

The Welcome message appears at the very beginning of your survey, before the first question. It's a great way to introduce your survey and set expectations.

It's disabled by default — to use it, you need to enable it explicitly.

Enabling and disabling

The header of the Welcome editor shows an Active toggle. Click it to enable or disable the message. When disabled, the survey starts directly with the first question.

Editing the content

  • Title — defaults to the placeholder "Hello and welcome"
  • Message — defaults to the placeholder "You have been invited to take a survey. Share your reactions, ideas and views. Thank you in advance for your contribution."
  • Add a media — attach an image, a video or a logo to the welcome page

Both Title and Message have an Improve button that runs an AI request to refine what you wrote.

Options menu

The Options dropdown in the header contains:

OptionDescription
Customise buttonsCustomise the text of the next and previous buttons

Thank you message

The Thank you message appears at the very end of your survey, after the last question is answered. It's a chance to thank respondents and confirm their submission.

It's disabled by default — like the Welcome message, you need to enable it explicitly via the Active toggle in the header.

Editing the content

  • Title — defaults to "Thank you very much!"
  • Message — defaults to "You have just completed your survey. Thank you very much for taking the time to respond."
  • Add a media

Both fields have an Improve button (AI suggestion) just like the Welcome message.

Options menu

The Options dropdown in the header contains two options:

OptionDescription
Add confettiAdd some fun with a confetti animation at the end of the survey. ;-)
Customise buttonsCustomise the text of the next and previous buttons

The generic question editor

When you click on a question in the sidebar, its editor opens in the main area. The layout is the same for all question types, with type-specific fields in the answers section at the bottom.

The question header shows:

  • The question's icon and type name (e.g., Multiple choice, Open question…)
  • A language flag (e.g., EN) indicating the language you're currently editing
  • A Required toggle on the right
  • An Options dropdown (more on this below)

Required toggle

When Required is enabled, the respondent has to answer the question to move on to the next one. When disabled, they can skip it. Off by default.

Question, Description and media

Below the header, three editable fields:

  • Question — the question title. Has an Improve button next to it that runs an AI request to refine what you wrote.
  • Description — optional extra details shown below the title.
  • Add a media — attach an image or video to display alongside the question.

Answers

The answers section depends on the question type — for example, Multiple choice shows a list of answer fields, Opinion scale shows a numeric range, etc. See the individual question type pages for the details of each.

Options menu

The Options dropdown contains actions and settings for the question. The available options vary by question type, but the following are common to all questions:

OptionDescription
ConditionsJump from a question to another based on user input. — used to define skip logic
Customise buttonsCustomise the text of the next and previous buttons
Duplicate questionMake an exact copy of the question
Delete questionPermanently remove the question from the survey

Other options are type-specific — for example, Multiple choice has a Multiple answers option to allow more than one selection. These type-specific options are documented on each question type's page.

tip

Welcome and Thank you messages don't have Conditions, Duplicate or Delete options — they're always first and last in the survey, can't be branched, and can only be disabled (not removed).

Cerebro — AI assistant

In the bottom right of the editor, you'll see a small Cerebro badge. Cerebro is Told's AI assistant; it can suggest questions and improvements based on the context of your survey. The Improve buttons in the editor are the most direct way to interact with it — they send the current text to Cerebro and ask for a refined version.

Dynamic variables

You can personalize your questions and descriptions using dynamic variables. Insert a variable using the {{variable_name}} syntax anywhere in a question title or description.

When the survey is displayed to a respondent, each {{variable_name}} placeholder is replaced with the matching value from the respondent's properties (set via the SDK's identify function or hidden fields). If the variable doesn't exist for that respondent, the placeholder is removed (replaced with nothing).

Example:

If your question title is:

Hello {{name}}, how satisfied are you with our service?

And the respondent has a name property set to Toto, they will see:

Hello Toto, how satisfied are you with our service?

tip

This works in both question titles and descriptions, as well as in Welcome and Thank you messages.

Question types

Each question type has its own dedicated page describing its specific fields and options:

  • Multiple choice — coming soon
  • Open question — coming soon
  • Opinion scale — coming soon
  • Net Promoter Score — coming soon
  • Message — coming soon
  • User information — coming soon
  • Calendar — coming soon
  • IA Agent — coming soon