Web integration

Web integration puts a survey directly onto your own website. After you install one small piece of code, the widget can invite visitors to take a survey without ever leaving the page they're on — no email, no link to share. You decide which surveys run, where they appear, how they look, and how often someone sees them.

Everything here is organized around the idea of a site: a workspace that has the widget installed and at least one survey switched on. You manage your sites from Survey Manager → Web Integration, and each one gets its own card showing how many of its surveys are currently active.

One widget per workspace

The install code is tied to a workspace, not to an individual survey. You install it once per workspace, and every survey underneath that workspace shares the same installation. That's why the page groups everything by workspace — the domains you allow, the master switches, and the install snippet all belong to the workspace as a whole, while each survey keeps its own look-and-feel settings.

When you add a site, you pick the workspace, the domains the widget should run on, and the surveys you want to switch on. Surveys that already had the widget configured are marked as Existing so you can tell them apart from fresh ones.

Widget types

Every survey can be shown in one of three layouts:

• Box — a floating box anchored to a corner of the screen. You choose the corner (top-left, top-right, bottom-left, or bottom-right) and whether it opens maximized automatically or stays collapsed until the visitor clicks the feedback button.
• Box Classic (Popup) — a classic pop-up box. It shares the same corner-position and maximized options as the floating box.
• Embedded — the survey is woven directly into your page rather than floating over it. Instead of a corner, you give the widget a placeholder on your page (a CSS selector) and choose whether the survey is inserted before, inside, or after that element.

The layout is set per survey, so one workspace can run a discreet corner box on its homepage and an embedded survey inside a checkout page at the same time.

Allowed domains

Each workspace has a list of allowed domains — the websites the widget is permitted to run on. Add a domain by typing its address (including https:// or http://); the widget will only appear on the domains you've listed.

You can also set a blocklist per survey: full page URLs where that survey should be suppressed even though its domain is allowed — a thank-you page or a cancellation page, for example. Each blocklist entry is matched against the page address from the start, so the prefix you enter covers every page beneath it. Blocklist entries should sit under one of the workspace's allowed domains.

Mobile and language

Two workspace-wide switches control reach and language:

• Show on mobile — turn the widget on or off for mobile visitors. When a workspace is switched off entirely, mobile is automatically off too.
• Auto-detect language — let the visitor's browser decide which language the survey appears in. Turn auto-detect off to pin every survey to a specific language instead.

Display rules: position, caps, and frequency

Beyond the layout, each survey has timing and placement controls so the widget feels considerate rather than intrusive:

• Position — the corner (for boxes) or the placeholder and insertion point (for embedded surveys), as described above.
• Delay cap — the minimum time a visitor must browse before the survey appears, set in minutes, hours, and days. Use it to wait until someone has actually engaged with the page.
• Frequency cap — the minimum time before the same visitor sees the survey again on the same device, also in minutes, hours, and days. This is what stops people from being asked over and over.
• Blocklist — the suppressed-page list described under Allowed domains.

The master active toggle

Each survey has its own Active switch, and each workspace card has master switches that drive every survey in the workspace at once — active, mobile, and language. Flip the workspace Active switch and every survey beneath it follows. A workspace only appears as a live "site" once at least one of its surveys is active; workspaces where every survey is switched off stay tucked away until you re-enable them.

Installing on your website

Applying changes across a workspace

When you change a master setting — switching a workspace off, changing its language, or editing its allowed domains — you commit it with Apply changes. The update walks every survey in the workspace one by one, showing a progress bar as it goes, so a single click rolls your change out everywhere. Your allowed-domain list is always carried along with these changes, so toggling a switch never accidentally clears the domains the widget runs on.

Related articles