Using Indexed Element Attributes in Search & Page Analytics

A note on indexed element attributes

Admins and Architects are the only team seats that have permissions to add new indexed element attributes. If you are a Standard user, you'll need assistance from one of these team seats in your Settings > Account Management > Users view.

Jump to section:

• How Indexed Element Attributes work in Fullstory
• Index List
• Do Not Index List
• Configure pattern rule lists for element attributes
• Searching using element attributes

How Indexed Element Attributes work in Fullstory

The indexed element attribute feature allows you to take advantage of more stable attributes on your selectors, even while the class names constantly change. Attributes also help to make the CSS on your site unique which improves the benefit of Fullstory features, including named elements and heatmaps. 

In the Default Attributes view, we'll show attributes already indexed in search for all Fullstory accounts, such as data-component data-test and aria-labelledby.

In the Configured Attributes view, we'll show attributes that were either autoconfigured by Fullstory based on user sessions captured or were manually added by an Admin or Architect user on your account. Element attributes that were autoconfigured will have Fullstory listed under the Created by column on the Configured Attributes view. Fullstory will check for and autoconfigure element attributes once a day.

Admin and Architect users can configure pattern rule lists for attributes or delete attributes on the Settings > Data Management > Indexed Element Attributes page. When an auto-configured attribute is deleted, it will not be automatically reconfigured by Fullstory unless it it re-added by an Admin or Architect user at a later time. 

If you're not seeing an attribute from your website listed on on this page, an Admin or Architect user can add additional attributes by clicking Create Attribute. 

Index List

The attributes that we index by default are listed here.

The following attributes are conditionally allowed.

Do Not Index List

We don't index certain very common attributes (shown in the table below) since attributes are meant to identify important and unique elements around the site. These attributes cannot be manually configured.

Configure pattern rule lists for attributes

So you've identified a new Element Attribute that you'd like to add to Fullstory for Indexing - great!

When you edit or create a new Element Attribute, a pattern rule is required to index the attribute value. Click Add Rule to input the specific patterns you'd like to include or exclude. You can use wildcard * to specify a greater range of patterns.

Searching using element attributes

Once attributes have been configured and new sessions have been captured containing the elements you'd like to search for, you can start filtering using those attributes. To do so, you'll want to toggle the Any activity drop down and select Clicked. You will then have the option to search the clicked event by CSS selector where you can search for engagement on a specific element without using class selectors.

See the images below for steps on how to refine a search using element attributes.

Refine your search to find engagement on a specific element containing specific text.

And use data categories to search for engagement categories across multiple elements.