How Popsee Displays Surveys
Understanding how Popsee chooses which survey to show and when helps you create a better experience for your visitors.
One API Key, All Your Surveys
Your Popsee account has a single API key that works for all your surveys. You only need to install the script once on your website, and Popsee handles the rest.
No code changes needed when you create new surveys. Just set your targeting rules in the dashboard and your new survey will automatically appear to the right visitors.
How Popsee Chooses Which Survey to Show
When a visitor lands on your page, Popsee evaluates your active surveys in order:
- Domain prefix check — Each survey can have a domain prefix (e.g.,
https://mysite.com). Only surveys matching the current page URL are considered. - Targeting rules — Popsee checks conditions you've configured: URL patterns, device type, time on page, scroll depth, and custom parameters.
- First match wins — The first survey that passes all checks is selected. If you have multiple surveys, order them by priority in your dashboard.
Tip: Always set a domain prefix for each survey. Without one, a survey could appear on any site using your API key.
Respecting Your Visitors
Popsee is designed to gather feedback without being annoying. Here's how we protect the visitor experience:
No repeat surveys
Once a visitor has seen or completed a survey, they won't see the same one again. Popsee stores a visitor ID in localStorage to remember who has already responded.
Survey fatigue protection
After showing any survey, Popsee waits 24 hours before showing another one to the same visitor. This prevents survey overload even if you have multiple active surveys.
Easy dismissal
Visitors can always close a survey with one click. If they dismiss it, they won't be asked again for that survey.
Non-intrusive display
Surveys slide in from the corner of the screen and don't block page content. Visitors can continue browsing while the survey is visible.
Targeting Options
Control exactly when and to whom your surveys appear:
| Option | Description |
|---|---|
| Domain prefix | Only show on pages starting with this URL |
| URL pattern | Match specific pages using regex patterns |
| Device type | Target desktop, mobile, or tablet visitors |
| Time on page | Wait until visitor has been on page for X seconds |
| Scroll depth | Trigger after scrolling X% down the page |
| Exit intent | Show when visitor moves to leave the page |
| Custom parameters | Target based on data you pass (user plan, role, etc.) |
Testing Your Surveys
To test a survey without affecting your analytics:
- Open your browser's Developer Tools (F12)
- Go to Application → Local Storage
- Find and delete any keys starting with
popsee_ - Refresh the page to see the survey again
You can also use your browser's incognito/private mode for a fresh visitor session each time.