SessionSight: Surveys
Overview
Use this page to review survey results and create new surveys for a SessionSight container. A survey is a short set of questions shown to visitors of a tracked application or site to capture direct feedback, such as satisfaction or a Net Promoter Score (NPS), instead of only inferring intent from clicks and page views. Surveys give you an explicit signal that complements the passive behavioral data SessionSight already records for that container.
Surveys belong to one specific container, so the container must already be installed and verified, and your account needs SessionSight configuration write permissions before New survey and the row delete controls become available. Once a survey collects responses, those results show up in this list and in the survey's own results page, alongside the container's other SessionSight signals.
This page lists every survey created for the selected tenant and container, with its format, question count, status, response volume, response rate, negative share and NPS badge, and its most recent change. From here you open New survey to start one from a ready-made template or a blank question, open any row for its full results, or delete a survey you no longer need.
Key concepts
- Survey - A short set of questions shown to visitors of a container to capture direct feedback, such as satisfaction or a Net Promoter Score, rather than only inferred behavior. (related: SessionSight: Feedback)
- Container - A monitored website or application that SessionSight's tracking snippet reports on; each container has its own independent survey list. (related: Configuration: SessionSight: SessionSight)
- Template - A ready-made set of questions you can start a new survey from, so you do not have to build every question yourself; choosing Blank survey instead starts from a single open question.
- NPS badge - A score derived from visitor responses that classifies a survey's sentiment: good at 30 or higher, neutral between 0 and 29, critical below 0, and none until the survey has NPS-type answers.
- Response rate - The share of times a survey was shown that resulted in a completed response, shown as a whole percentage.
When to use it
- When you want to see how many visitors have responded to each survey in a container and whether sentiment is trending up or down.
- When you need to launch a new satisfaction or NPS survey from a ready-made template.
- When you want a quick, lightweight check with a single open question using Blank survey, without building a full question set.
- When you're deciding whether to keep, retire, or delete a survey with a low response rate or a critical NPS badge.
- When you're switching between tenants or containers to check whether each application has active feedback surveys running.
Before you begin
- A SessionSight container must already be installed and verified for the site or application you want to survey (SessionSight: Install and verify).
- Your account needs SessionSight configuration write permissions to create or delete surveys; without them, New survey is unavailable and rows cannot be deleted (Operations: Permissions).
- Know which tenant and container you want to review, since the dropdowns at the top of the page determine which surveys the list shows.
Common workflows
Review surveys collected for a container
Persona: Load-test operator or SessionSight admin
- Select the tenant and container you want to check using the dropdowns above the table.
- Expect: The table reloads with that container's surveys, or shows "No surveys in this container yet" if none have been created.
- Read each row's Responses, Shown, Response rate, Negative share and NPS badge.
- Expect: No data changes; you can compare which surveys are getting responses and which have a critical or good NPS.
Verify: The table lists exactly the surveys that belong to the selected tenant and container, with figures matching what you expect from recent visitor activity.
Start a new survey from a template
Persona: SessionSight admin with configuration write access
- Click New survey.
- Expect: The template picker opens, listing the available templates plus a Blank survey option.
- Click a template, or click Blank survey if none fits.
- Expect: The survey editor opens, pre-filled with the template's questions, or with a single open question for Blank survey.
Verify: After you save the survey in the editor and return to this page, the new survey appears as a row in the table with zero responses until visitors start answering.
Delete a survey you no longer need
Persona: SessionSight admin with configuration write access
- Click the row's Delete control.
- Expect: A confirmation dialog opens naming the survey and warning that deleting it cannot be undone.
- Click Delete survey in the dialog.
- Expect: The row disappears from the table; the survey and all its responses are permanently removed.
Verify: The deleted survey no longer appears in the list, and no inline error is shown above the table.
Steps
Step 1
Open the Surveys page.
Expected result: The page loads with the tenant and container from your current context already selected, 24h highlighted as the default time range, and since this container has no surveys yet, the panel shows "No surveys in this container yet" with guidance to start one with New survey.
This is the starting point for either reviewing existing surveys or creating the first one for this container.
- The tenant and container dropdowns above the table identify whose surveys you're viewing.
- 24h is the default highlighted time range, though it does not filter this list.
- Use New survey to start building your first survey for this container.
Field reference
| Field | Purpose | Format / Validation | Required | Default |
|---|---|---|---|---|
| Tenant selector | Chooses which organization's SessionSight data you are viewing; switching it changes the list of containers and clears the currently shown surveys. | dropdown | No | the tenant from your current context |
| Container selector | Chooses which monitored application or site's surveys to show; each container's survey list is independent, so switching containers replaces the entire table. | dropdown | No | the container from your current context |
Column reference
| Column | What it shows | How to read it |
|---|---|---|
| Survey name and format | - | The first line is the survey's name; the second line states its format and how many questions it has, so you can tell at a glance what kind of prompt visitors see and how long it takes. |
| Status | - | Shows whether the survey is currently able to collect responses; compare status across rows to see which surveys are active and which are not. |
| Responses | - | The total number of completed responses the survey has received; read it together with Shown to judge whether the survey is reaching enough visitors. |
| Shown | - | The number of times the survey was presented to visitors; it is the denominator behind Response rate, so a low Shown count makes the rate less reliable. |
| Response rate | - | The share of times shown that resulted in a completed response; a low rate relative to similar surveys can mean the trigger or wording is putting visitors off. |
| Negative share | - | The proportion of responses classed as negative; a rising negative share points to a specific pain point worth investigating even if overall response volume is healthy. |
| NPS badge | - | Good means the survey's NPS is 30 or higher (promoters outweigh detractors), neutral means it sits between 0 and 29, critical means it is below 0 and needs attention, and none means the survey has no NPS answers yet. |
| Last change | - | The most recent time the survey's questions or settings were edited, not when responses last came in. |
Controls reference
New survey
Opens the template picker, a panel listing the available survey templates plus a Blank survey option.
When to use: When you want to start building a new survey for the currently selected container.
Side effects: Read-only: it only opens the picker, nothing is created until you pick a template and complete it in the survey editor. Only available with SessionSight configuration write permissions.
Template item
Opens the survey editor pre-filled with that template's question set.
When to use: When one of the ready-made templates already matches what you want to ask, for example an NPS check.
Side effects: Read-only navigation: no survey exists until you save it in the editor.
Blank survey
Opens the survey editor starting from a single open question.
When to use: When no template fits and you want full control over the question set from the start.
Side effects: Read-only navigation: no survey exists until you save it in the editor.
Time range buttons (1h / 4h / 8h / 24h / 7d / Custom)
Switches which range is highlighted in the filter bar.
When to use: Not useful on this page for filtering the survey list itself; it has effect only where other pages use the same shared time-range control.
Side effects: Read-only, and on this page it has no effect: the survey list always shows every survey for the selected container regardless of which range is highlighted.
Row Delete control
Opens a confirmation dialog naming the survey and warning that the action cannot be undone.
When to use: When a survey is no longer needed and you want to remove it along with its collected responses.
Side effects: Opening it makes no change by itself; it requires SessionSight configuration write permissions to appear.
Delete survey (confirm)
Permanently deletes the survey and removes its row from the table.
When to use: Only after you've confirmed in the dialog that this is the survey you intend to remove.
Side effects: Mutating and irreversible: the survey and all its responses are deleted. A failure leaves the row in place and shows an inline error above the table.
Close
Dismisses the delete confirmation without deleting anything.
When to use: When you opened the delete confirmation by mistake or changed your mind.
Side effects: Read-only: no data changes.
Verify the result
The task succeeds when the table lists every survey you expect for the selected tenant and container, with each row's Responses, Shown, Response rate, Negative share and NPS badge matching what you know about that survey's recent activity. After creating a survey through New survey and saving it in the editor, its row appears in this list with zero responses until visitors start answering. If the panel still reads "No surveys in this container yet" after you've created one, re-check that the tenant and container dropdowns match the container the survey was created in. If a deleted row is gone and no inline error appears above the table, the deletion succeeded.
Troubleshooting
- Symptom: The list says "No surveys in this container yet" even though you expected existing surveys. Fix: Check that the tenant and container dropdowns above the table match the container the surveys were created in; surveys are scoped to one container at a time.
- Symptom: The New survey button is missing or does nothing when clicked. Fix: Your account lacks SessionSight configuration write permissions; ask an administrator to grant them in Operations: Permissions.
- Symptom: Changing the time range (1h, 4h, 24h, and so on) doesn't change which surveys appear. Fix: This is expected: the survey list always shows every survey regardless of the selected time range; open a survey's own results page to look at a specific period.
- Symptom: Deleting a survey fails with an inline error above the table. Fix: Your role may lack SessionSight configuration permissions, or the survey may have already been removed by someone else; refresh the page and check Operations: Permissions.
- Symptom: The template picker shows an error instead of a list of templates. Fix: The container could not be found or you no longer have access to it; confirm the container still exists and that you have access in Configuration: SessionSight: SessionSight.
Related articles
- Prerequisite: SessionSight: Install and verify - a container must be installed and verified before its surveys can collect responses
- Prerequisite: Configuration: SessionSight: SessionSight - tenant and container setup live here and determine what this page can show
- Prerequisite: Operations: Permissions - grants the SessionSight configuration write access needed to create or delete surveys
- See also: SessionSight: Dashboard - shows the container's overall activity alongside its surveys
- See also: SessionSight: Feedback - a related feedback-collection feature in the same module