Skip to content
Open Screeb

Embed a survey in your page

Show a survey inside an element of your website, such as below a help article, and pick that element with a CSS selector or by clicking it on your site.

How-to4 min read, updated Oct 15, 2026

An embedded survey shows inside a page of your website, in the element you choose, instead of over the page. Use it to collect feedback next to content: at the end of a help article, below a pricing table, in an empty state.

  1. Open the survey and click Design & targeting at the top.
  2. On the Type of interaction page, click Embedded survey. If another channel opens instead, click Audience targeting under Embedded survey in the side menu.
  3. Under Embedded in, click the selector field. A window opens.
  4. In Element, type the CSS selector of the element, or pick it on your site (next section).
  5. Click Save to close the window.
The Audience targeting page of an embedded survey, with the Embedded in field showing the CSS selector of the element

The survey is added at the end of the first element that matches the selector, once that element is visible. Some examples:

Selector Matches
#feedback The element with the id feedback.
.article-footer Elements with the class article-footer.
main .article-footer Elements with that class, inside main.
.pricing, .plans Elements with either class.

When you do not know the selector, let Screeb find it:

  1. In the window, click Pick an element. The button needs a role that lets you edit surveys. The Choose a URL window opens.
  2. Under Page URL, enter the address of a page of your website where the Screeb tag is installed, or click one of your recently used pages. Click Choose.
  3. Your page opens in a new tab. Hover the page and click the element where the survey goes.
  4. Back in Screeb, the Element field is filled. Click Save.
The Embedded in window, with the Element field and the Pick an element button

Prefer a stable selector, such as an id your developers add for Screeb. Generated class names change with each release of your site, and the survey then finds no element.

Below Embedded in, set the trigger, the users, the pages and the devices as for any survey, see Choose who sees your survey. On top of these rules, the survey shows only when its element is on the page: on a page without it, nothing happens.

Then click Save at the top right, and the button that reads Set live followed by the channel name.

Embedded surveys have their own default design, in the Survey design settings group of the settings: Embedded survey. There, you set the Overall size, the colors, the font, the borders, and whether to Display close button. The size, the close button and the border settings need advanced customization in your plan. There is no position to set: the element decides where the survey sits.

To change the design of this survey only, click Design under Embedded survey and switch to Specific design. See Customize the design of your surveys.

The default design of embedded surveys, with the size, colors and close button options and the live preview

The survey appears in your page, as part of its content, for the users who match its targeting. If the element leaves the page, the survey goes with it, and it comes back when the element does. Several embedded surveys can show on the same page, and next to a proactive survey.

Save is disabled with “A CSS selector is required for the "In page" interaction.” The Embedded in field is empty. Enter a selector before you save or set the survey live.

The field shows “Enter a valid CSS selector” The selector has a typo, such as a space after # or an unclosed bracket. Fix it, or pick the element on your site.

The survey does not show. Check that the element is on the page and visible: open your browser’s developer tools and run document.querySelector("your-selector"). Then check the targeting with Screeb Inspector. With the On manual trigger in your code trigger, the field is locked and your code starts the survey.

Pick an element opens the page but nothing comes back. The page has no Screeb tag, or the tag belongs to another workspace. Use a page where the tag of this workspace is installed.