Skip to content

Email ​

The Email page configures the messages a survey sends to respondents: their wording, reminder schedules, and consent retention. It covers:

  • Invitation and invitation reminder emails sent to a team audience;
  • Submission confirmation receipts;
  • Opt-in reminders for unsubmitted forms;
  • Hand-sent follow-up emails (results and reports and follow-up survey) after data is analyzed.

This is a configuration page only. No recipient list is managed here, and no invitation run is launched from it — you can only send a preview test email to yourself or trigger a follow-up send.

The page has two independent channels. The form channel is an Email or Account Email field in the builder; the invitation channel is the editor's opt-in on Share → Distribute. The form channel's purposes are available without invitations. Turning on invitations creates the Invitation and Invitation reminder messages; ticking a purpose with a message under Purposes creates that purpose's message item.

The survey Email page showing the Purposes checkboxes at the top and the message tabs below
The Email page showing the Purposes picker and the Submission confirmation tab.

Email Tabs and Items ​

The page is organized into message and configuration tabs:

TabItem IdentifierDelivery ChannelTrigger / CadenceMerge FieldsSend Test
Invitationemail-invitationTeam AudienceLaunched from Distribute{{link}} (required), {{name}}, {{survey_title}}, {{organiser}}Yes
Invitation reminderemail-invitationReminderTeam AudienceAutomated schedule or manual sendSame as InvitationYes
Submission confirmationemail-confirmationForm Field / InvitationAutomatic upon submission{{link}}, {{name}}, {{survey_title}}, {{organiser}}Yes
Reminderemail-reminderForm Field (opt-in)Hourly automated scheduleSame as Confirmation ({{link}} optional)Yes
Results and reportsemail-resultsForm opt-in & AudienceManual one-off sendSame as Confirmation ({{link}} optional)Yes
Follow-up surveyemail-followUpSurveyForm opt-in & AudienceManual one-off sendSame as Confirmation ({{link}} optional)Yes
AdvancedSurvey settingsSurvey-levelConfiguration tab (Advanced mode)N/AN/A
SentSend logAll sendsReal-time delivery trace tableN/AN/A
The survey Email page in Advanced mode showing the Advanced tab in the tab bar
In Advanced mode, the tab bar includes the Advanced settings tab alongside the active message tabs and Sent history.

Email Items in Compose and Localize ​

Each email message is stored as a survey item (email-invitation, email-invitationReminder, email-confirmation, email-reminder, email-results, email-followUpSurvey) with its subject and body in the item's locale/{language} documents.

  • On Share → Email, each message tab edits the survey's primary language.
  • In Build → Compose, active email items appear in the structure tree below Terms and Conditions, grouped under an expandable Email row. Selecting an email item in Settings Mode lets you edit its internal Name and Description alongside its primary-language Subject and Body.
  • In Localize Mode (in Build → Compose or Build → Localize), expanding Email lets you translate each message's Subject and Body into every target language side by side with the primary language. The server Translate action and JSON translation Import/Export include all active email items automatically.
The Compose view with the Email group expanded in the tree and Submission confirmation selected
Active email items appear under the Email group row in Build → Compose.
The Compose view in Localize Mode showing the French translation of the Submission confirmation email item
Translating an email item's subject and body in Localize Mode.

Invitation Opt-In ​

Invitations are opt-in per survey. The Invitations section of Share → Distribute shows a Send email invitations switch once the survey's team has at least one audience. The switch writes the survey's email.invitationEnabled setting and creates or removes the Invitation and Invitation reminder items:

  • Off: the Invitation and Invitation reminder items are removed (soft-deleted) and no audience email is sent. The form channel still works: when the form collects an address, the Purposes picker and the purpose tabs it selects remain available, and confirmations, reminders and follow-ups reach form recipients.
  • On, without an Email or Account Email field: the Invitation, Invitation reminder, Advanced (in Advanced mode) and Sent tabs are available, plus any purpose tabs ticked under Purposes (such as Submission confirmation, which confirms invited submissions at the invitation address).
  • On, with a field: the Invitation, Invitation reminder, the selected purpose tabs, Advanced (in Advanced mode) and Sent are available. Results and follow-ups reach both the form opt-ins and the invited audience.

Turning the switch off stops invitation traffic and audience sends. Soft-deleted email items keep their previous locale content if re-enabled, the form channel is unaffected, and the Sent history stays readable.

Invitation and Invitation Reminder Emails ​

The Invitation and Invitation reminder tabs configure the messages sent when you distribute the survey to a team audience from Share → Distribute.

The Invitation tab on the Email page
The Invitation tab showing the merge fields summary, subject and body editors, and Send test email action.

Invitation Email ​

What each invited recipient receives with their unique survey link (/v2/{surveyId}/i/{token}):

  • Language: Each language has its own subject and body, stored in the email-invitation item's locale document and translated in Build → Compose (Localize Mode) or via the Translate action. A complete, valid recipient-language invitation is used as-is; a missing, half-written or invalid one falls back to the complete primary invitation, and the send dialog reports how many recipients fall back.
  • Subject: Plain-text subject line (up to 200 characters).
  • Body: Markdown-formatted message body with a live Preview tab.
  • Links: A link is delivered exactly as written. The platform disables the mail provider's click tracking, so the recipient receives the invitation URL (/v2/{surveyId}/i/{token}) — in the HTML and the plain-text part — instead of a tracking redirect.

Invitation Merge Fields and Validation ​

Both the subject and body support the merge fields. Validation runs continuously on both the Invitation and Invitation reminder tabs:

  • Missing {{link}} displays an error (The message needs {{link}}.) and blocks sending an invitation run from Distribute.
  • Any unrecognised {{placeholder}} displays an error (Unknown placeholder(s): ...) and blocks sending.

Invitation Reminder Email and Schedule ​

The Invitation reminder tab defines the message sent to invited recipients who have not yet submitted, along with the default reminder cadence for new invitation runs:

The Invitation reminder tab on the Email page showing the message editor and the Reminder schedule controls
The Invitation reminder tab configures both the optional reminder template and the default invitation reminder schedule.
  • Reminder message: If you provide a custom Subject and Body, scheduled and manual invitation reminders use that template. If you leave the Invitation reminder message empty, the platform automatically reuses the invitation email with a Reminder N of M: prefix on the subject line and a This is reminder N of M from <organiser>. reason line.
  • Language fallback: The reminder is picked from the complete, valid recipient-language reminder, then the complete, valid recipient-language invitation, then the complete primary reminder, then the complete primary invitation — never mixing languages.
  • Reminder schedule: Below the editor, Reminder schedule sets how many automated reminders follow the invitation (No reminders, 1 reminder, 2 reminders, or 3 reminders) and the delay in days after the previous send (Reminder 1 after (days), Reminder 2 after (days), etc.). Each gap runs from the previous send; opening or starting the survey does not reset the clock, and a recipient who submits is never reminded. The Distribute composer starts from this schedule and writes adjustments back to the survey, while each launched run freezes the schedule it was created with.

Every invitation and reminder email automatically appends a mandatory platform footer that cannot be removed:

  • Reason line: Identifies which team invited the recipient (<organiser> invited you to take part in this survey.).
  • Privacy policy link: Links to the platform privacy notice explaining how invitation records are handled.
  • One-click unsubscribe: A unique link that records an organization-wide suppression for that address and immediately stops all future invitations and reminders from the customer.

Emails are sent from the platform's domain using the team name as the display name and a team admin's address as the default Reply-To. The display name and the survey-level reply-to can be overridden on the Advanced tab. For an invitation run, the Reply-to selector in the Distribute composer chooses a member of the survey team; leaving it blank uses the team owner's email address.

Merge Fields ​

Every message's subject and body support the same placeholders. The invitation is the only message that requires the link; the confirmation, the form reminders and the follow-ups treat it as optional.

Merge FieldRequiredResolved Value
{{link}}Invitations onlyThe recipient's unique invitation URL (/v2/{surveyId}/i/{token}) in an invitation or invitation reminder; the survey's public link (/v2/{surveyId}) in the confirmation, the form reminders and the follow-ups.
{{name}}NoThe recipient's name when the platform knows it — the audience record for an invitation, the account name for a submission confirmation; there otherwise.
{{survey_title}}NoThe survey's title.
{{organiser}}NoThe team's display name; the survey's title when the team has none.

An invitation or invitation reminder with a missing {{link}} or an unknown placeholder is not sent. The confirmation, the form reminders and the follow-ups send without {{link}}; an unknown placeholder is left as written.

Send Test ​

Every message tab — Invitation, Invitation reminder, Submission confirmation, Reminder, Results and reports, and Follow-up survey — has a Send test email button (sendEmailTest).

Send test email button and Test email sent notification
Sending a test email preview to the signed-in editor's address.
  • The recipient address is resolved on the server from the caller's authenticated account, never from the page.
  • Send test email is disabled until the message has both a subject and a body (Add a subject and body to send a test.). An invitation or invitation reminder with a missing {{link}} or an unknown placeholder is not sent.
  • The preview uses the survey language's content and test merge values: {{name}} is Test and {{link}} is /v2test/{surveyId}.
  • A test creates no invitation run, consent record, respondent actor or Sent-history row, and does not alter any audience or progress counters.
  • When the mail service accepts the preview, the page displays Test email sent.

Email Purposes ​

The Purposes picker at the top of the page sets the survey's email purposes (email.defaultPurposes). Purposes belong to the survey rather than individual fields: configuring purposes here or in an Account Email or Email field in Build → Compose modifies the same survey-level setting.

PurposeKeyDelivery ChannelsRespondent ConsentExport BehaviorDescription / Item Created
Submission confirmationconfirmationForm field & InvitationsAutomatic (transactional)Excluded unless Dataset selectedSends a confirmation receipt upon survey completion (email-confirmation).
RemindersreminderForm field onlyExplicit opt-in checkboxExcluded unless Dataset selectedSends automated reminder cadence while form is unsubmitted (email-reminder).
Results and reportsresultsForm opt-in & InvitationsExplicit opt-in checkboxExcluded unless Dataset selectedManual one-off email to share findings or reports (email-results).
Follow-up surveyfollow-up-surveyForm opt-in & InvitationsExplicit opt-in checkboxExcluded unless Dataset selectedManual one-off email inviting respondents to a future study (email-followUpSurvey).
DatasetdatasetForm field answerNone (standard answer)Included in raw, humanized, anonymizedIncludes collected address in dataset exports as questionnaire data.

Operational Addresses vs. Dataset

Any purpose other than Dataset treats the address as operational only: it is stored separately from questionnaire answers and omitted from all data exports (see Data Privacy and Security).

Submission Confirmation ​

The confirmation email (email-confirmation) is sent automatically when a respondent completes the survey:

  • Trigger Conditions: Sent if the form collects an address under the Submission confirmation purpose, or if the submission originated from an invited team audience link. When both apply, duplicate sends to the same address are automatically prevented.
  • Localization: Translated per survey language in Build → Compose (Localize Mode) or via the Translate action; falls back to the primary language confirmation if incomplete.
  • Unsubscribe: Transactional receipts carry an explanatory notice but omit unsubscribe links. Test submissions never trigger emails.

Reminders ​

The reminder email (email-reminder) reaches respondents who started the survey but have not yet submitted:

  • Opt-In Requirement: An email field with the Reminders purpose displays an explicit opt-in checkbox and legal notice. Nothing is recorded or scheduled unless the respondent ticks the box.
  • Storage & Privacy: Stored as an operational session consent (RespondentEmail) with the agreed notice version; never visible to editors or included in exports.
  • Unsubscribe & Cadence: Each reminder includes a one-click unsubscribe link. The hourly reminder cadence is managed under Advanced Settings.

Follow-up Emails ​

Follow-up emails allow contacting respondents after data collection and analysis:

The Results and reports tab on the Email page showing the message editor, Send test email button, and Send results and reports action
The Results and reports tab includes both Send test email and the one-off Send results and reports action.
  • Configuration: Write the Subject and Body on the Results and reports (email-results) or Follow-up survey (email-followUpSurvey) tab. An incomplete primary message is never offered as an opt-in to respondents.
  • Audience Scope: Reaches form respondents who ticked the corresponding opt-in checkbox and, if invitations are active, the survey's invited audience (omitting unsubscribed, bounced, or suppressed recipients).
  • Manual Execution: Follow-ups are not automated. Click Send results and reports or Send follow-up survey to review recipient counts and trigger the delivery.

Sent History ​

The Sent tab lists all survey email delivery actions, newest first. Each row represents a single batch send action (displaying target count, delivered, opened, and bounce/suppression status) rather than exposing individual recipient addresses.

Advanced Settings ​

In Advanced Mode, the Advanced tab configures global email options that span across messages:

Setting AreaGoverned ControlsDefaultReference
Consent NoticesCustom notice text and opt-in labels for reminders, results, and follow-upsSystem defaultsNotice Wording
Respondent RemindersNumber of reminders (None, One, Two), delay gaps in days, cut-off deadline1 reminder, 3 daysReminder Schedule
Consent RetentionExpiration period for consent records (1 to 365 days)180 daysRetention Rules
Sender IdentitySender display name and survey-level Reply-To addressSurvey title, Team adminSender Settings

See Advanced Email Settings for full parameter tables and configuration instructions.