Virtually everything about your digital experience is captured and indexed in Fullstory. With OmniSearch, you can run powerful queries to target sessions that match specific user and event criteria. In this article, cover:
User filters
When you capture custom user properties in Fullstory, you have multiple ways to search for that data:
- User filters let you search for the most recent data associated with a particular user, which is to say, at present. This is what you see when you view a user in Fullstory.
- Dependent criteria on event filters let you search for the user property data at a specific point in time, which is to say, in the past.
User property data can change over time. Use user filters to search for user property data as it is right now. Use dependent criteria on event filters to search for user property data as it was set in the past. See How to Search Custom User Data for an in-depth guide.
| User Filter | Description | Web and Mobile App Support |
| Any user | Finds any and all users. Use this option when more specific user criteria isn’t relevant for your search. | ✓ |
| Finds users by email address when you're passing in the user's email address using our Set User Properties API or our Identify Users API. | ✓ | |
| Name | Finds users by name when you’re passing in the user's displayName via a call to either our Set User Properties API or our Identify Users API. | ✓ |
| Signed-Up Status | Finds users who have been identified by a unique user ID (uid) via our Identify Users API. |
✓ |
| User ID | Finds users by specific uid that you’re passing into Fullstory via our Identify Users API. |
✓ |
| Total active time | Finds users by the total amount of time they have been active on your site. | ✓ |
| Total time | Finds users by the total amount of time they have spent on your site, including time in which they were inactive. | ✓ |
| Average session active time | Finds users by the average amount of time a user is active on your site during a session. | ✓ |
| Average session length | Finds users by the average length of time a user spends on your site during a session, including time in which they were inactive. | ✓ |
| First seen | Finds users by the date they were first seen by Fullstory. | ✓ |
| Total sessions | Finds users by the total number of sessions captured for a user. | ✓ |
| Last seen | Finds users by the most recent date a user accessed your site. | ✓ |
To further customize your user filters, consider using our Set User Properties API to get even more advanced. This API lets you send custom user data to Fullstory that you can use to target users based on properties that are important to your business. For example, search by criteria like user role, product interest, or average spend.
Event filters
| Event Filter | Description | Web and Mobile App Support |
| Any activity | Finds any and all activities. Use this option when more specific event criteria isn’t relevant for your search. | ✓ |
| Custom Event | Finds activities where configured events have occurred. | ✓ |
| Visited Page | Finds activities where users visit a specific page. To read about the differences between Pages & URLs, check out this article. | ✓ |
| Visited URL | Finds activities where users visited a specific URL. | Web Only |
| Clicked | Finds activities where a user clicked on an element. | ✓ |
| Changed | Finds activities where a user changed a specific element on your website, such as an input field. You can even use this filter to search for the exact text a user entered into a specific input field (i.e. a form field or search bar). | ✓ |
| Pinch-to-zoom | Finds activities where a user zoomed in or zoomed out using a touch device. | Web Only |
| Refreshed URL |
Finds activities where a users refresh their pages using their browser refresh button or keyboard shortcut. Learn more about refreshed page here. |
Web Only |
| Highlight | Find activities where a users highlight content on a page. Learn more about highlight here | ✓ |
| Rage clicked | Finds activities where a user rage clicked (i.e. clicked repeatedly on an element in a short period of time). Learn more about rage clicks here. | ✓ |
| Error clicked | Finds activities where a user error clicked (i.e. clicked on an element and triggered an error). Learn more about error clicks here. | ✓ |
| Dead clicked | Find activities where a user dead clicked (i.e. clicked on an element with no response from the browser). Learn more about dead clicks here. | ✓ |
| Thrashed cursor | Find activities where a user thrashed their cursor (i.e. moved their cursor back and forth rapidly out of frustration). Learn more about thrashed cursor here. | Web Only |
| Suspicious activity | Finds activities where a suspicious activity occurred (i.e. text may have been inputted by a SQL injection or cross-site scripting attack instead of a user). Learn more about suspicious activity here. | Web Only |
| Navigated to Screen | Finds activities where a user navigated to a specific app screen. | Fullstory for Mobile Apps Only |
| Crashed | Finds activities where a crash occurred. |
Fullstory for Mobile Apps (Android only) |
| Low Memory | Finds activities where data capture stopped due to low device memory. | Fullstory for Mobile Apps Only |
| Backgrounded | Finds events where users background the app. Learn more about backgrounded events here. | Fullstory for Mobile Apps Only |
| Abandoned form | Finds activities where a user started filling out a form, but left before submitting their data. Learn more about form abandonment here. | Web Only |
| Watched Element | When configured in Fullstory Advanced & Enterprise accounts, this finds activities where an element rendered on the page and specifies if it was visible in the user’s viewport. | ✓ |
| Page load | Finds activities with a specific page load time. | Web Only |
| DOM content loaded | Finds activities with a specific DOM content load time. | Web Only |
| First Contentful Paint | Finds activities with a specific First Contentful Paint time. | Web Only |
| Network error URL | Finds activities where an Network error occurred. | ✓ |
| Uncaught Exceptions | Finds activities where an uncaught exception occurred. | ✓ |
| Console error | Finds activities where a console error occurred. | ✓ |
| Copied | Finds events where users highlighted text and copied it. | Web Only |
| Pasted | Finds events where users highlighted content. | Web Only |
| Cumulative Layout Shift | Finds events that measures the largest burst of layout shift scores for every unexpected layout shift that occurs during the entire lifespan of a page. | Web Only |
| First Input Delay | Finds events that measures the time from when a user first interacts with your site (when they click a link, tap a button, or use a custom, JavaScript-powered control) to the time when the browser is actually able to respond to that interaction. | Web Only |
| Interaction to Next Paint | Finds events that measures the latency of every tap, click, or keyboard interaction made with the page, and--based on the number of interactions--selects the worst interaction latency of the page (or close to the highest) as a single, representative value to describe a page's overall responsiveness. | Web Only |
| Time to Interactive | Finds events that measures the time from when the page starts loading to when its main sub-resources have loaded and it is capable of reliably responding to user input quickly. | Web Only |
| Total Blocking Time | Finds events that measure the total amount of time between First Contentful Paint (FCP) and Time to Interactive (TTI) where the main thread was blocked for long enough to prevent input responsiveness. | Web Only |
| Time to First Byte | Finds events that measure the time between the request for a resource and when the first byte of a response begins to arrive. | Web Only |
| Largest Contentful Paint | Finds events that measure the total amount of time between First Contentful Paint (FCP) and Time to Interactive (TTI) where the main thread was blocked for long enough to prevent input responsiveness. | Web Only |
| Detection Events | Monitor for the presence of any string that matches a predefined Detection Rule pattern. | ✓ |
| Fullstory API Error | Finds events where there were errors with usage of the Fullstory client API. | ✓ |
| Force Restart | Finds events where users background the app, swipe it away, and then restart the app. | Fullstory for Mobile Apps Only |
To further customize your event filters, consider using our Analytics Events API to get even more advanced. This API lets you send event data to Fullstory that you can use in search as well. For example, search for activities where users completed a purchase using criteria like order value, number of items purchased, or other event properties you configure.
Adding dependent criteria to event filters
Fullstory lets you add dependent criteria to event filters. Dependent criteria allows you to search for events when additional criteria is true. For example, the search below will return activities where the user clicked “Add to cart” when using a tablet.
| Dependent Criteria | Description | Web and Mobile App Support |
| City | Refines your search by the user’s city, derived from their IP address. | ✓ |
| State/region | Refines your search by the user’s state or region, derived from their IP address. | ✓ |
| Country | Refines your search by the user’s country, derived from their IP address. | ✓ |
| IP address | Refines your search by the user’s IP address. | ✓ |
| Browser | Refines your search by the user’s browser (i.e. Chrome, Safari). | Web Only |
| Browser Version | Refines your search by the user's browser version (i.e. 95.0.4638.54). | Web Only |
| Device Type | Refines your search by the user’s device type (i.e. Desktop, Mobile, Tablet). | ✓ |
| Platform | Refines your search by the user’s platform (i.e. Web or Mobile Apps). | Fullstory for Mobile Apps Only |
| Device model | Refines your search by the user's device model (i.e. Samsung SM-G970U or Apple iPhone8,4). | Fullstory for Mobile Apps Only |
| Device vendor | Refines your search by the user's device vendor (i.e. Samsung or Apple). | Fullstory for Mobile Apps Only |
| App version | Refines your search by the user's app version (i.e. "latest," or a specific App version number). | Fullstory for Mobile Apps Only |
| App OS version | Refines your search by user’s device version (i.e. iOS 14.4.2). | Fullstory for Mobile Apps Only |
| View | Refines your search by the screen viewed when the event occurred. | Fullstory for Mobile Apps Only |
| App package | Refines your search by the mobile app package name. | Fullstory for Mobile Apps Only |
| User agent | Refines your search by the user's user agent, a string of browser information unique to each visitor on the web. | Web Only |
| Page | Refines your search by the specific page visited, based on definition in your Page Settings (Data Management > Pages). | ✓ |
| Previous Page | Refines your search by previously visited page in a user's journey. | ✓ |
| Entry Page | Refines your search by the page the user started their session on. | ✓ |
| Exit Page | Refines your search by the page the user ended their session on. | ✓ |
| Operating system | Refines your search by the user’s operating system (i.e. Windows, OS X, Chrome OS). | ✓ |
| Time on Page | Refines your search by the total time a user spent on a page where the event occurred. | ✓ |
| Time on Page Active | Refines your search by the total time a user was active on a page where the event occurred. | ✓ |
| Time on Page Inactive | Refines your search by the time a user spends on a page while inactive on a page. | ✓ |
| Time since page load | Refines your search by the time elapsed since page load. | Web Only |
| Time since session start | Refines your search by the time elapsed since the session began. | ✓ |
| Console errors on page | Refines your search by the number of console errors on the page. | ✓ |
| Console warnings on page | Refines your search by the number of console warnings on the page. | ✓ |
| Display width | Refines your search by the width of the user’s display (i.e. the screen they’re using). | ✓ |
| Display height | Refines your search by the height of the user’s display (i.e. the screen they’re using). | ✓ |
| Viewport width | Refines your search by the width of the user’s viewport (i.e. the visible area of a webpage). | ✓ |
| Viewport height | Refines your search by the height of the user’s viewport (i.e. the visible area of a webpage). | ✓ |
| Visited URL | Refines your search by the URL where the event occurred. | Web Only |
| Referrer URL | Refines your search by the URL visited immediately prior to the event. | Web Only |
| Refines your search by the user's email address when you're passing in their email via a call to either our Set User Properties API or our Identify Users API. | ✓ | |
| Name | Refines your search by the user's name when you're passing in a displayName value via a call to either our Set User Properties API or our Identify Users API. | ✓ |
| Signed-Up Status | Refines your search based on whether users have been identified by a unique user ID (uid) via our Identify Users API. |
✓ |
| User ID | Refines your search by the specific uid that you’re passing into Fullstory via our Identify Users API. |
✓ |
| Scroll Depth |
When searching for visited URL events, refines your search by how far a user scrolled on the page. Learn more about scroll depth here |
Web Only |
| Gesture | When searching for pinch-to-zoom events, refines your search by whether the user zoomed in or zoomed out. | Web Only |
| Occurrence | A threshold set for how many times a user took an action. | ✓ |
| Text | Refines your search by the text associated with a specific element. For example, finding clicks on a "Buy Now" button. | ✓ |
| CSS Selector | Refines your search based on the CSS Selector. | ✓ |
| Element | Refines your search based on a Named Element which has been configured within your Fullstory account. Learn more about named elements here. | ✓ |
| Session Type | Allows you to filter sessions based on whether it was a live session or a preview session. You can learn more about preview sessions here. | ✓ |
| Session Start | Allows you to drill into sessions based on when the session started. | ✓ |
| Event Time | Allows you to drill into events based on when the specific event occurred. | ✓ |
To further customize your dependent event filters, use Set User Properties API, Identify Users API or Analytics Events API to leverage your own custom properties.
Excluding users with exclusion filters
You may want to fine-tune your search filter to exclude users who performed certain events. If so, click Exclude users who performed... at the bottom of the Event filters area. Users who match the events you specify will be excluded from your search results.
Disabling filter rules
While narrowing down your search criteria, you may wish to temporarily disable individual filter rules. To do so, click the three vertical dots (⋮) next to the filter rule you wish to disable and choose Disable. Disabled filter rules will appear in grey.
FAQ
What is the difference between the "in any order" and "in this order" filters?
"In any order" implies that different filters can match the same event while "in this order" is the only way to guarantee that unique events are matched.