Publish and share
The Publish tab is where you publish your link survey and get the tools to distribute it. Unlike website surveys, link surveys don't have triggers, audience targeting, or scheduling — you publish them and share the link.
You'll find it as the second top-level tab of the survey editor (after Content and before Results).
Layout
The Publish tab has two sub-tabs at the top:
- Configure (default) — the main publishing and sharing interface
And a blue Publish button at the top right that ships the survey live.
The Configure tab has a left sidebar with three distribution methods, each opening its own page in the main area:
| Method | Description |
|---|---|
| Share link | Copy the link or download the QR code to share your questionnaire |
| Embed iframe | Easily integrate your questionnaire on your site with a piece of code |
| Display in an e-mail | Allow your audience to take your survey via e-mail |
Share link
The default view. It walks you through three steps.
Step 1 — Publish your survey
"To start receiving your first responses, please publish"
Click Publish to go live. Once published, the button turns into a red Pause button to stop collecting responses. The top-level tab label also changes from "Publish" to "Published".
A confirmation modal appears when you click Publish:
Would you like to publish your Told?
If you publish your survey, it will be visible from now until you stop it.
Step 2 — Options
"Do you want to add options to your survey link?"
Two toggles:
| Option | Default | Description |
|---|---|---|
| Single vote | On | "Allow the user to vote only once." — prevents the same user from submitting multiple responses |
| Password protect | Off | "Respondents will need a password to complete the survey." — when enabled, reveals a text input to set the password |
Step 3 — Share the link
This step appears after publishing.
"Share this link to your respondants"
- A text field displaying the survey URL (e.g.
https://app.told.club/survey/{surveyID}/voting) - A Copy button to copy the URL to your clipboard
- A QR code button to download a QR code image that points to the survey URL
Hidden fields
You can pass user information to your survey by appending query parameters to the voting URL. Any parameter you add will be stored as a hidden field on the respondent's profile and will be visible in the report's Testers tab under "Hidden Fields".
For example:
https://app.told.club/survey/{surveyID}/[email protected]&name=John&company=Acme
This is useful when you already know who the respondent is (e.g. sending personalized links from a CRM or email campaign). The hidden fields are attached to the respondent's source author profile and can be used for filtering and analysis in the report.
You can add as many custom parameters as you need. Common examples include email, name, company, plan, or any custom identifier.
The following parameter names are reserved and used internally by Told: toldLanguage (sets the survey language), toldAnswer (pre-selects an answer), and preview (enables preview mode). Don't use these as hidden field names.
Embed iframe
Embed your survey directly on a web page using an iframe.
Step 1 — Publish your survey
Same as the Share link step 1.
Step 2 — Copy the embed code
"Insert the code below in the section of your website where you want your questionnaire to be displayed."
A code block displays the iframe snippet:
<iframe title='My survey title' height='579px' width='594px'
frameborder='0'
src='https://app.told.club/survey/{surveyID}/voting'>
</iframe>
Click Copy to copy the snippet to your clipboard. Paste it into your website's HTML where you want the survey to appear.
Display in an e-mail
Share your survey by embedding the first question directly in an email.
"Allow your audience to take your survey via e-mail. Only the first question will be visible in the e-mail."
The page includes a Desktop / Mobile preview toggle and a language selector to preview the email in different languages.
Step 1 — Publish your survey
Same as the Share link step 1.
Step 2 — Preview
"Here's an example of your first e-mail question"
A preview of how the first question will look in the email, with "From:" and "Subject:" fields.
The survey must contain at least one question before the email preview and code are available.
Step 3 — Copy the email code
"Insert the code below in your email"
An HTML code block containing the email-safe markup for the first question. Click Copy code to copy it. Paste the HTML into your email template or email builder.
Differences from website survey publishing
Link surveys have a fundamentally different publishing model from website surveys:
| Feature | Website survey | Link survey |
|---|---|---|
| Triggers (page visit, click, custom event) | Yes | No |
| Audience targeting | Yes | No |
| Period (date range, recurrence, display once) | Yes | No |
| Webhook connector | Yes | No |
| Share link + QR code | No | Yes |
| Embed iframe | No | Yes |
| Email embed | No | Yes |
| Single vote | No | Yes |
| Password protect | No | Yes |