Named Elements

Available for the following Plan types:

FullStory Enterprise

FullStory Business

FullStory for Mobile Apps

FullStory Free

Available to the following User roles:





Named Elements let you assign your own 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 Named Elements

There are two ways to set up Named Elements: from Inspect Mode and from Settings. 

Creating a Named Element from Inspect Mode

Screen Recording 2022-04-22 at 10.48.30 AM.gif

  1. While watching a session, go to Page Insights > Inspect Mode. 
  2. Click on the element you'd like to name, then click "Name element."
  3. Name your element and add a description. 
  4. Click "or" to assign the same name to multiple selectors. 

Creating a Named Element from Settings

Screen Shot 2022-06-21 at 11.53.30 AM.png

  1. Go to Settings > Data Management > Elements.
  2. Click "Create Element." 
  3. Name your element and add a description. 
  4. Add the selector you'd like to name.
  5. Click "or" to assign the same name to multiple selectors.
  6. Select any Data Capture Options that you'd like to apply to this element
    1. "Watch this Element" helps you determine if an element rendered on the page and if it was visible in the user’s viewport. Click here to learn more about Watched Elements.
    2. If you'd like this element to be excluded from being classified as a Rage Click or Dead Click, check those boxes accordingly.
  7. Click "Save."

Using Named Elements

After you create a Named Element, you can search for it by name 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 Named Elements retroactive?
Yes! After you create a Named Element, you can use it to search through all past and future FullStory data. However, Named Elements are not retroactive in Journeys or Dimensionality Cards.

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?
No, FullStory will not alert you that your Named Element no longer exists on your site. 

Do Named Elements work with webhooks?
No, Named Elements 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 a Defined Event and a Named Element?
Named Elements apply to CSS selectors only whereas Defined Events allow you to assign a name to specific user behavior. You can reference a Named Element when creating a Defined Event (for example, clicked element “Add to Cart” when the Visited URL starts with /category-listing”). 



Need to get in touch with us?

The FullStory Team awaits your every question.

Ask the Community Technical Support