Skip to main content

Survey Customization

Every survey is fully customizable. Access these options in the Customization tab of the survey editor.

Theme​

Choose between two base themes:

  • Light — Light background, dark text
  • Dark — Dark background, light text

Color​

Set the active color (primary accent) used for buttons, selections, and highlights. Enter a hex color value (e.g., #4F46E5).

Gradient​

Optionally enable a gradient background:

  • Color — CSS gradient value
  • Animated — Animate the gradient
  • Active — Toggle gradient on/off
  • Logo — Upload a logo displayed in the survey header
  • Cover image — Add a visual element shown at the top

Avatar​

Add a personal touch:

  • Active — Toggle avatar display
  • Image — Upload a profile picture (team member, mascot, etc.)
  • Name — Display a name below the avatar

Overlay​

When the survey displays, an overlay can cover the background:

  • Active — Toggle overlay
  • Color — dark or light
  • Blur — Enable blur effect with configurable intensity

Position​

Control where the survey appears on screen using positionX and positionY coordinates.

Full screen​

Enable fullScreen to make the survey take over the entire viewport.

Close button​

blockClosing controls whether users can dismiss the survey:

  • Off (default) — Users can close via the X button
  • On — The survey stays open until completed or the user navigates away

Branding​

branding controls the "Powered by Told" badge. On paid plans, disable it for a white-labeled experience.

Welcome message​

The survey can start with a welcome message before the first question:

  • Content — Introductory text (translatable)
  • Description — Additional detail
  • Button — CTA text (translatable)
  • Media — Image or video

Thank-you message​

After the last question, a thank-you message is displayed:

  • Content — Completion text (translatable)
  • Description — Additional detail
  • Button — CTA text (translatable)
  • Media — Image or video
  • Confetti — Enable confetti animation on completion

Survey options​

OptionDescription
oneTestPerUserAllow only one response per user
seeItOnlyOnceShow the survey only once, even if not completed