Set Up a Website Widget Survey
Embed a feedback survey right on your site — popup, slide-in, or inline. No page redirects needed.
- You need admin access to do this. About roles
- Set Up a Website Widget must be set up first.
A Website Widget Stream lives directly on your site. Respondents give feedback without ever leaving the page. If you want in-context reactions instead of routing people to a separate survey link, this is the one.
Check your widget on mobile and tablet too. Over half of responses often come from phones — make sure the experience is smooth on every screen size.
Create the Stream
- Go to Streams in the sidebar and click +. A type selection panel appears.
- Select Website Widget. The wizard opens with two tabs: Blocks (active by default) and Settings.
Build Your Survey
This is where you design what respondents see. Each question or screen is a Block, and you can add up to 100 of them.
Add languages
The Blocks tab starts with a language selector at the top. If your survey needs translations, click Edit next to Available languages before adding blocks.
Select your languages in the modal. Once added, every question field will show one input per language, so you can enter translations inline as you build.
Add and arrange blocks
Click Add new block to create your first block. Each block starts with a type picker — five buttons across the top. Drag and drop blocks to reorder them at any time.
Pick the type that fits your question:
| Type | What it does | Use it when... |
|---|---|---|
| Smiley | 5- or 2-point smiley face scale. Produces a satisfaction index score. | You want a quick "how was your experience?" gauge. |
| NPS® | The standard 0–10 "how likely are you to recommend us?" scale. | You need the industry-standard loyalty metric. |
| Multiple Choice | A list of text options (up to 100). | Demographic questions, categories, or any closed-ended question. |
| Free Text | An open text field for written comments. | You want verbatim feedback in the respondent's own words. |
| Break | An informational screen — not a question. Shows Title instead of Question and collects no response. Can redirect to a website in a new tab. | Welcome messages, section dividers, or redirects. |
Configure a block
- Type your question in the Question field (required, max 100 characters). For Breaks, this is labeled Title.
- Expand Show more fields to optionally add a Description Text (subheading, max 1000 characters) or a Friendly Name (internal label for reports — available on all types except Break). Image uploads are not available on Widget blocks.
- Configure the type-specific settings (see below).
- Tick This question is required if the respondent must answer before continuing. (Not available on Break blocks.)
Choose 5 smileys or 2 smileys — this choice is locked after you save. Then pick an Index: Insights Index (default), NPS, CSAT, CES, NAS, PAS, or VPS. Two-smiley mode excludes NPS and CES. The default works for most cases; pick a specific one if your organization tracks an industry standard. See What Do the Scores Mean?.
Enter a Min value label (e.g. "Not at all likely") and a Max value label (e.g. "Extremely likely"). Both are required, max 100 characters. The index is automatically set to NPS.
Add your answer options (up to 100). Toggle Randomize order of options to prevent position bias. Set Maximum responses per respondent — 1 means single-select, higher allows multi-select.
Let Location users compare their scores against peers — either within the same folder or across all locations on this Stream. Available on Smiley, NPS, and Multiple Choice blocks. See Share Results Between Locations for the full guide.
Show or hide blocks based on earlier answers — for example, show a follow-up question only if the respondent chose "Unhappy." Available from the second block onward. See Add Branching Logic for the full guide.
The exit block
Every Widget stream includes an Exit block at the bottom, pre-populated with "Thank you!" as the title. Expand Show more fields to add a Message and a redirect URL (Open a website in a new tab) — useful for sending respondents back to a product page or landing page after they finish.
Configure Settings
Click the Settings tab to define when and where your survey runs.
- Enter a Stream name (required) — make it descriptive, like "Customer Feedback Q1".
- Set the Schedule this Stream period: start date, start time, end date, and end time (all required).
- Under Select Touchpoints, tick at least one Touchpoint from the checkbox tree. Some may be grayed out due to feature restrictions.
- Configure Survey Quota to control how often respondents can reply — Unlimited (default), Only one time, or Every [interval]. Quotas require at least one unique identifier.
- Leave Show in Details on (default) if you want this Stream visible in the Dashboard's Details view.
- Pick a Sentiment index — choose which Smiley or NPS block represents the overall experience for this stream.
- Toggle Show in Overview to display this stream's score on the Overview. When enabled, choose a Period and optionally turn on comparison with a previous period.
- Click Save. Your widget is ready to go live on your website.
The question you select here becomes the single number that represents this stream on the Overview and in reports. Pick the question that best captures overall satisfaction.
When you limit responses to Only one time or Every [interval], you must enable at least one identifier: Browser history (on by default), Email, Phone, or Custom ID. If multiple are enabled, drag them to set priority order. These identifiers let the system recognize returning visitors so it can enforce the limit. Browser history works silently but can be bypassed in private browsing. Email or Phone requires respondents to identify themselves — more reliable but adds friction.
Even though your widget is embedded on your site, you can also generate up to 10 standalone URLs that open the same survey directly — useful for email campaigns or QR codes. This is a premium feature.
Turn feedback into a competition between Locations — rank them by satisfaction score, improvement, or both on a leaderboard. Requires at least one Smiley or NPS block. See Set Up Gamification for the full guide.
Good to Know
Widget streams support five block types — Smiley, NPS, Multiple Choice, Free Text, and Break. Picture Choice is not available because image-based answer options are not supported in the widget format. Need visual options? Use a Link stream instead.
Once you save a block with 5 smileys or 2 smileys, you cannot change it. Need the other variant? Delete the block and create a new one.
A single Widget stream supports up to 100 blocks. If you are hitting that ceiling, consider splitting your survey into multiple streams.
What's Next
Your stream is live. Head to the Dashboard to see incoming responses.
Was this helpful?