Documentation

Configuring how your survey looks

Configure respondent-facing appearance and interface wording from the Theme tab. Changes update the respondent-rendered preview before you save, so you can check the actual survey experience rather than relying on a simplified mock-up.

The style specifies whether to use a traditional web forms style or the mobile-friendly chat style. For a full comparison of the two — including pros and cons, head-to-head performance, and guidance on when to choose each — see Traditional or Chat based survey experience?. For a per-instrument breakdown of how each question type renders in each style, see the Chat vs. Traditional compatibility matrix.

Use the Question type selector above the preview to check representative question layouts while you work. The preview reflects unsaved changes to the survey style, colors, type, spacing, assets and interface text.

Appearance

The Appearance section provides coordinated controls for the whole respondent experience:

  • Survey style switches between Chat conversation and Traditional form.
  • Logo or avatar sets the Chat survey avatar and is hidden for Traditional forms.
  • Client logo adds separate client branding in both Chat and Traditional surveys. Select None to remove it.
  • Background image accepts a preset or account image, or None for no background.
  • Show progress indicator controls the respondent progress display.
  • Font selects the main survey typeface.
  • Text size, Corner rounding, Spacing, Shadows, and Color palette provide presets. Choose Custom on any control to edit its individual values without resetting the other appearance settings.

Use Reset theme changes to discard unsaved Theme-tab changes and return to the saved theme.

  1. Open Theme → Appearance.
  2. Select an account image in Client logo, or upload the image to your account first if it is not listed.
  3. Check the respondent preview in the survey style you intend to use. The logo keeps its original proportions, so check wide and tall artwork at mobile as well as desktop sizes.
  4. Save the survey when the preview looks right. Select None and save to remove the client logo.

The client logo is separate from Logo or avatar: a Chat survey can show both, while a Traditional survey uses the client logo without the Chat avatar. Switching styles does not require a different logo asset.

Traditional form Theme editor with Client logo selected and the MX8 Labs logo visible above the question in the respondent preview

In the Traditional form preview, the client logo appears above the question.

Chat conversation Theme editor showing separate Logo or avatar and Client logo controls, with the avatar and white client logo in the preview header

The Chat preview shows the avatar on the left and the separate client logo on the right. Choose artwork with enough contrast against the header color.

Survey text

The Survey text section controls the messages and labels respondents see, including headings, answer hints, validation messages, buttons, accessibility text and the messages displayed while the next question loads. Less common labels are available under More survey text.

Keep placeholders such as {seconds} and {label} unchanged when editing a message. Custom theme wording is included in the survey's translation editor and translation spreadsheet as independently editable entries, even when two entries currently share the same translated text.

Expand Header and footer in the Theme tab. Enter Markdown in Survey header or Survey footer, then check the live respondent preview. Use these fields for persistent study information, formatted text or links such as a sample provider's privacy policy.

For example:

Code
Please read our [Privacy policy](https://example.com/privacy) before continuing.

Raw HTML is not rendered. Links open in a new tab so respondents keep their place. Leave a field empty to remove its region; logo, avatar and client-branding settings remain separate.

Chat shows the header below branding and the footer above the answer composer. Traditional forms show the header near the branding and the footer below the question area. Both remain available on the completion screen. Preview both layouts and a narrow screen before saving.

Save the survey before editing Translations or opening a language test link. Nonempty headers and footers appear in the normal translation catalog alongside other survey text. Preserve the Markdown link destinations when translating, then inspect the saved translation in its language test link. Clearing the source text removes that region in every language.

Theme Header and footer section with a Markdown survey header, an empty footer field and the rendered heading above the live question preview

Advanced styling

Use Custom CSS only when the appearance controls cannot express the required design. Preview each supported question type and both desktop and mobile layouts before fielding, because custom rules can affect controls differently.

Progress and transition messages

Turn on Show progress indicator in the Theme tab and save the survey to display progress to respondents. Leave it off when progress should be hidden. The indicator is an estimate based on answered questions and completed respondent paths, so branching can affect it; it reaches 100% when the survey completes.

Theme controls with the Show progress toggle beneath the question hints, shown switched off

The control above is switched off. When enabled, respondents see the circular progress indicator at the top right:

Respondent survey view with a circular progress indicator at the top right

Between questions, the respondent experience can display localized messages such as “Saving your response…” and “Loading the next question…”. These transition messages follow the survey language. Check them alongside your theme's question hints when reviewing translated surveys.

Images

The Logo or avatar and Background image dropdowns expose the presets listed below. To use your own imagery, upload a custom image to your account and it appears alongside the presets in the picker:

PathImage
/themes/shanna/shanna.jpegshanna
/themes/chipmunk/chipmunk.pngchipmunk
/themes/john/john.pngjohn
/themes/robo/robo.pngrobo
/themes/shanna/background.jpegShanna theme background
/themes/chipmunk/chipmunk-bg.jpegChipmunk theme background
/themes/john/john-bg.jpegJohn theme background
/themes/robo/bg.jpegRobo theme background