Element recording rule exceptions allow you to apply element recording rules to some, but not all, elements that match a selector. This gives you a high degree of control over the user data FullStory records. In this article, we’ll review the benefits of using element recording rule exceptions and how to get started.
This feature is not supported on FullStory for Mobile Apps.
The Benefits of Element Recording Rule Exceptions
Exclude some, but not all, elements that match a selector
There are many cases where you may wish to exclude or mask some, but not all, elements that match a particular selector.
For example, we highly recommend you configure an element recording rule to exclude or mask all
input elements across your site. This ensures FullStory won’t capture any potentially sensitive customer data entered into form fields like email or street address.
However, you may find there are specific
input elements you would like to capture. For example, your site search contains a wealth of insights about how users navigate your digital experience. By adding an element recording rule exception, you can tell FullStory to apply recording rules to certain
input elements but not others.
In this scenario, you could set up a rule that excludes all elements with the selector
input and add an exception to the rule for all elements with the selector
input.safe. Then, simply add the selector
input.safe to your site search and any other elements you wish to track.
Future-proof your site against accidental data leakage
Element exception rules also provide a great way to future-proof your site with user privacy in mind. By creating restrictive recording rules and applying exceptions to specific selectors, you ensure that new elements added to your site match the most restrictive rule by default–safeguarding sensitive data as your site evolves.
Let’s continue the example above. We’ve masked all elements with the selector
input and added an exception for elements with the selector
input.safe. If a new
input gets added to your site in the future, it will be automatically masked by default. The
input would only be unmasked if its selector was purposefully changed to
input.safe, preventing FullStory from unintentionally recording any data from new
This feature must be configured by an Admin user.
In FullStory, create and manage your element recording rules under Settings > Privacy > Element Recording Rules. Use the field “Rule Exception Element Selector” to specify which selector(s) should be exempt from the rule. Your rule will not apply to any elements that match this criteria.
Note: Exceptions must be simple selectors. Combinators are not supported.
Do element recording rule exceptions apply to code-first rule management?
There are two different approaches to managing your element recording rules. The first is to implement the appropriate CSS classes into your element libraries, an approach we refer to as “code-first.” The second method for managing element recording rules is through the FullStory Element Recording Rules UI located in Settings > Privacy.
Element recording rule exceptions apply only to the in-app Element Recording Rules located in Settings > Privacy. They do not apply to rules set using the code-first approach.
Why should I use an element recording rule exception instead of creating multiple recording rules to control which elements are masked and unmasked?
Element recording rules will always apply the most restrictive block rule that matches an element. For example, if you have one rule that masks
input and another rule that unmasks
input.safe, FullStory will respect the most restrictive rule and apply the mask to both
input.safe. Element recording rule exceptions allow you to manage this more effectively and reduce the number of recording rules in your account. Win-win!
Are element recording rule exceptions retroactive?
No. Adding a new element recording rule exception will only affect FullStory’s recording behavior from that point forward.
Are element recording rule exceptions supported on FullStory for Mobile Apps?
No, element recording rule exceptions are not supported on FullStory for Mobile Apps.