Definitions

Overview

LogRocket supports the creation of Definitions as a business-friendly wrapper around the most crucial parts of their application. For example, if there is a particular URL pattern or CSS selector that maps to a particular page or button ('Checkout' page or 'Add to Cart' button), you can define those once as a Definition and leverage that Definition throughout LogRocket.

Creating Definitions

Navigate to the Definitions tab within Settings. You'll see a list of your current Definitions if any exist, including their name, description, type (page or event), as well as when they were last edited.

To create a new Definition, click the ‘Add New Definition’ tab in the top corner. A ‘New Definition’ modal will appear:

13601360

As you start to fill in the Definition, you will see an indicator appear letting you know whether it matches any sessions. This can help you confirm that the text or selector you have entered is correct.

Definitions today can be defined with either Click, Visited URL, or Element Visible filters, corresponding to Click, Page, and Element events. We currently only support a single filter within each Definition. You can add an optional 'Description' to clarify what the Definition refers to.

📘

All Definitions are team-visible

Currently, we do not support the creation of personal Definitions. All Definitions that are created are visible and editable by all team members.

Using Definitions

You can use Definitions in most places that you use filters.

You'll see a new "Taxonomies" category in the omnibar with a new filter called "Use Definition".

312312

When you select this, you'll see a filter appear with a list of all Definitions within your application. Select the desired Definition to search for sessions matching it.

14521452

You can also use Definitions when creating charts within the Metrics section. Definitions are available for user when creating Timeseries charts or adding filters to any chart. They are also available when creating Funnels or Path Analysis.

Element Visible filter and "Use as Error State" option

When the "Element Visible" filter to create a definition, a "Use as Error State" checkbox appears at the bottom of the form:

10881088

Designating a definition as an "error state" includes the definition to be collected in Issues as an Error State issue type.

Note: Element visible definitions are non-retroactive, meaning they will record events after being defined, but will not look back in time before their creation date.