Audience
The Audience section gives you a complete view of all users who have interacted with your source through the Told SDK. You can filter them, inspect individual profiles, create named audience segments, and import users from external files.
To open it, navigate to your source and click Audience in the sidebar.
The audience page only displays data for the last 90 days. This retention window depends on your plan.
Users table
The main view shows a paginated table of all users matching the current filters.
| Column | Description |
|---|---|
| ID | The user ID (set via identify()) or an auto-generated anonymous ID |
| Name | User name, if identified |
| User email, if identified | |
| Language | Detected browser/device language, displayed with a flag |
| Last action | Date of the user's most recent action (page view, click, etc.) |
| Last answer | Date of the user's most recent survey response |
| Last created | Date the user was first seen on the source |
Click any row to open the user detail drawer.
User detail drawer
Clicking a user opens a side panel with four tabs:
Informations
Displays the user's profile, split into three sections:
Informations -- Identity fields sent via the SDK's identify() method:
- Name, Company, Plan, Email, ID, Language, Address, Title, Avatar, Description, Website, Phone
Other data -- Any custom properties passed through identify() that don't map to a standard field above.
Activity -- Behavioral data tracked automatically:
| Field | Description |
|---|---|
| First seen | When the user was first recorded on this source |
| Last action | Most recent event (page view, click, etc.) |
| Last answer | Most recent survey response |
| Device | Device type (desktop, mobile, tablet) |
| Number of solicitation (Told) | How many times a survey has been shown to this user |
| Number of sessions | Total session count |
Events
Lists all events triggered by this user (page views, clicks, custom events, etc.), with pagination.
Surveys
Shows the user's survey responses with dates.
Product tours
Shows the user's product tour interactions with dates.
A delete button in the drawer header lets you remove the user from the source.
Filters
Filters let you narrow down the users table. A default Date filter is always present. Click "New filter group" to add more filters.
When you have multiple filters, they are connected by a logical operator you can toggle: And (all conditions must match) or Or (any condition must match).
Use "Clear filters" to reset all filters, or "Hide Filters" / "Show Filters" to toggle the filter panel visibility.
Available filters
| Filter | Description |
|---|---|
| Name | Filter by user name |
| Language | Filter by detected language |
| Device type | Filter by device category |
| Number of sessions | Filter by session count |
| Number of solicitation | Filter by how many times a survey was shown |
| Visited page | Filter by page visited |
| Answer | Filter by survey responses |
| Click | Filter by click events |
| Custom event | Filter by custom events sent via the SDK |
| Date | Filter by time period |
| Properties | Filter by custom user or company properties |
| Scroll | Filter by scroll depth |
Name
Filters users whose name contains the entered text.
| Operator | Meaning |
|---|---|
| Contain | Name contains the value (only operator) |
Input: text field.
Language
Filters users by their detected browser or device language.
| Operator | Meaning |
|---|---|
| Any | Language matches any of the selected values |
| Not any | Language does not match any of the selected values |
Input: multi-select language list.
Device type
Filters users by the type of device they used.
| Operator | Meaning |
|---|---|
| Any | Device matches any of the selected types |
| Not any | Device does not match any of the selected types |
Available values: Desktop, Mobile, Tablet.
Number of sessions
Filters users by their total session count.
| Operator | Meaning |
|---|---|
| More or equal than | Session count >= value |
| Less than | Session count < value |
Input: number field.
Number of solicitation
Filters users by how many times a Told survey has been displayed to them.
| Operator | Meaning |
|---|---|
| More or equal than | Solicitation count >= value |
| Less than | Solicitation count < value |
Input: number field.
Visited page
Filters users who visited a specific page. You first select which part of the URL to match.
Field options:
| Field | Description |
|---|---|
| Url | Full URL |
| Path | URL path only (without domain) |
| Dynamic URL | URL with dynamic segments |
| Page name | Named page (if set via SDK) |
Operators:
| Operator | Meaning |
|---|---|
| Is equal to | Exact match |
| Is not equal to | Does not match exactly |
| Contain | Value contains the text |
| Does not contain | Value does not contain the text |
Input: text field with suggestions from recorded pages.
Answer
Filters users based on their survey responses. You first select a survey question, then choose a condition.
The available operators depend on the question type:
| Operator | Available for |
|---|---|
| Equal to | Multiple choice, Opinion scale |
| Not equal to | Multiple choice, Opinion scale |
| Any | Multiple choice, Opinion scale, NPS |
| Has answered | All question types |
| Has not answered | All question types |
Click
Filters users who clicked a specific element. You first select how to identify the element.
Element type options:
| Element type | Description |
|---|---|
| Click ID | Match by HTML element id attribute |
| Click Classes | Match by CSS class names |
| Click Text | Match by the text content of the clicked element |
Input: text field for the element identifier.
Click tracking must be enabled in your source's General settings for this filter to have data.
Custom event
Filters users by custom events sent through the SDK.
| Operator | Meaning |
|---|---|
| Is | Event field equals the value |
| Is Not | Event field does not equal the value |
| Exists | Event field exists (has any value) |
| Does Not Exist | Event field does not exist |
You select the event name, then optionally a field within the event data, then the operator and value.
Date
Filters users by when they were active. This is the default filter on every audience view.
Preset periods:
| Preset | Range |
|---|---|
| Today | Current day |
| Week to date | Start of the current week to today |
| Month to date | Start of the current month to today |
| Quarter to date | Start of the current quarter to today |
| Year to date | January 1st to today |
Custom date options:
| Option | Description |
|---|---|
| Last | Last N minutes, hours, days, weeks, or months |
| Period | A specific date range (between two dates) |
Properties
Filters users by custom properties set via the SDK's identify() method. You can filter on user properties or company properties.
Origin selector:
| Origin | Description |
|---|---|
| Author | Properties of the user |
| Company | Properties of the user's company |
Operators:
| Operator | Meaning |
|---|---|
| Equal to | Property equals the value |
| Not equal to | Property does not equal the value |
| Any | Property matches any of the selected values |
| Exists | Property exists (has any value) |
| Not exists | Property does not exist |
| Contain | Property contains the text |
| Does not contain | Property does not contain the text |
You first pick a property name from the list of recorded properties, then choose an operator and value.
Scroll
Filters users by how far they scrolled on a page.
Input: a percentage value (0--100%).
Scroll tracking must be enabled in your source's General settings for this filter to have data.
Creating audience segments
The "All audience" view shows every user on the source. You can create named audience segments by applying filters and clicking "Create new audience".
This button is enabled only when you have modified the filters from the current state. When you click it, you are prompted to name the new audience. The segment is then saved and appears in the sidebar under Audience, so you can switch between segments quickly.
On a custom audience, the button label changes to "Save audience" to save your filter changes. You can also rename, duplicate, or delete a custom audience via its dropdown menu.
Audience segments are used for survey targeting -- when publishing a survey, you can choose which audience segments should see it.
Companies
The Companies section (accessible from the sidebar) lists all companies (groups) associated with users on this source. Companies are created either via the SDK's identify() method (by passing company/group data) or via CSV/JSON import.
The companies table has the following columns:
| Column | Description |
|---|---|
| Name | Company name |
| Plan | Company plan, if set |
| ID | Company identifier |
| Last created | When the company was first recorded |
All columns are sortable. Click a row to open the company detail drawer, which shows the company's information and its associated users.
Import audience
You can import users or companies from external files. Go to Actions > Import audience to open the import wizard.
The import follows three steps:
- Upload CSV -- Drag & drop or browse for a file. Accepted formats:
.csvand.json. Maximum file size: 10 MB. - Select Data -- Map the columns in your file to Told fields.
- Review -- Confirm the mapping and import.
An example CSV file is available for download in the import dialog.
Actions menu
The Actions button in the top-right provides:
| Action | Description |
|---|---|
| Import audience | Opens the import wizard |
| Delete all users | Removes all users from this source (available only on the "All audience" view) |