Naming Elements in Fullstory

Who can use this feature?
- Available with all plans.
- Requires an admin or architect role. 

Naming Elements lets you assign your names to complex elements like CSS selectors. This helps make your Fullstory data more meaningful and easy to understand. After you name an element, you can search for it by name when analyzing your data. 

Getting Started with Naming Elements

There are two places you can name an element in Fullstory: Inspect Mode and Settings

Inspect Mode

If you're using a Fullstory Enterprise or Advanced plan:

  1. While watching a session, go to Page Insights > Inspect Mode. 
  2. Click on the element you'd like to name, then click Create Element.
    • If you have already created an element, you'll see Edit Element instead. 
  3. Use Data Studio to name the element, add a description, choose which platforms you'd like to monitor, and add any Capture Options. 
  4. Click Save

Tip: Use "Add selector" to assign the same name to multiple selectors. 


With any Fullstory plan: 

  1. Use Data Studio to name the element, add a description, choose which platforms you'd like to monitor, and add any Capture Options. 
  2. Click Save

Note: You can create up to 1,000 elements in your Fullstory account. 


After you name your element, you can search for it when building segments, funnels, metrics, journeys and dashboards. Use an Element filter to see a list of all elements in your account. 

Searching for a named element.png


Are Elements that have been named retroactive?
Yes! After you create or update an element, you can use it to search through all past and future Fullstory data. However, elements that have been named are not retroactive in Heatmaps, Journeys, Segments, Dimensionality Cards or Data Quality Monitoring. While searches for elements that have been named apply to sessions retroactively, the event log within those sessions is not updated in sessions that were captured prior to the element being created.

Are Watched Elements retroactive?
No. Read more on this here.

Will Fullstory let me know if my site's CSS changes and my element no longer makes sense?
Yes - Data Quality Monitoring helps you identify data objects that may have configuration issues.

Do elements that have been named work with webhooks?
No, elements that have been named don't work with Fullstory webhooks or other webhook-based integrations like Zapier. Please use custom events defined via the Fullstory JavaScript API for those integrations. 

What's the difference between defining events and naming elements?
Naming elements apply to CSS selectors only whereas defining events allow you to assign a name to specific user behavior. You can reference an element when defining an event (for example, clicked element “Add to Cart” when the Visited URL starts with /category-listing”). 

Will the platform option be visible for all Fullstory accounts, regardless if an account is using Fullstory for Mobile Apps?

Yes. All platform checkbox options (Web, iOS, and Android) will be visible in the element definition for any Fullstory account.

Will existing elements have the platform element selected?

For accounts with Fullstory for Mobile Apps, Fullstory will not pre-select Web, iOS, or Android checkboxes. The checkboxes will be unselected and an Admin will be prompted to select the Web, iOS, or Android once opening the element definition.

For accounts without Fullstory for Mobile Apps, the web checkbox will be selected by default. iOS and Android checkboxes will also be displayed, but aren’t selectable or active.

If I have two independent legacy elements for web and iOS, will those get combined into one element to manage?

No. For legacy elements, Fullstory will not combine the two element definitions into one. The element definitions will remain separate.

Can I combine two separate elements into one existing element definition or one new element definition?

Yes. An Admin can combine two element definitions into one. If two element definitions are combined into one existing definition, the new selector added to the existing element definition will be considered “new” and will not be retroactive.

An example of this would be having one existing web element definition and one existing iOS element definition that you want to combine into one element definition. If you add the iOS element definition to the existing web element definition, the iOS selector added is considered a “new” definition and is not retroactive.

How do I group elements together that have slightly varying CSS Selectors?

You can accomplish this by naming an element. When you name an element, it will take precedence for aggregations in Page Insights/Heatmaps. This creates an accurate count insight of the heatmap for all clicks on the elements you are interested in tracking.

Is there a limit to the number of elements I can create?

Yes. You can create up to 1,000 elements in each Fullstory account. 

Need to get in touch with us?

The Fullstory Team awaits your every question.

Ask the Community Technical Support