Tagging Recordings

Tagging your Recordings is a great way of noting specific actions, like CTA clicks, sign-ups, or visitor states. Once you've started to tag your Recordings, you can use the Tag filter in your Recordings filter panel. This allows you to filter through your Recordings and quickly identify issues your visitors are facing. 

You can tag Recordings in two ways:

• Manually: using the Hotjar admin interface.
• Automatically: using a JavaScript snippet on your site. This is only available to users on the Hotjar PLUS plan or above.

Tagging Recordings Manually

To add, edit or delete tags:

Open a Recording.

Select the Session Info panel from the top right.

Use the field provided to add new tags or delete existing ones by hitting the X next to them.

Tagging Recordings Using JavaScript

Recordings can be automatically tagged using a JavaScript code snippet. If your visitor visits any page which runs this JavaScript code, their Recording will be saved with the tag/s you set. To tag a Recording, add this JavaScript code:

hj('tagRecording', ['tag1', 'tag2']);

Doing so will cause all Recordings of visitors who pass through this page to include the two tags "tag1" and "tag2".

window.hj=window.hj||function(){(hj.q=hj.q||[]).push(arguments)};

Using multiple tags on different pages

If you add a tag to Page X and another tag to Page Y - and your visitor visits both pages, the Recording will be saved with both tags. In other words, tags will accumulate throughout the visitor's entire session. If you add the same tag on multiple pages, Hotjar will automatically detect the duplicates and only save one tag.

Example 1: Tagging users who logged into your app

To identify users who logged in, add the following tag to your admin pages.

hj('tagRecording', ['Logged In User']);

Example 2: Tagging users who tried to sign-up

To track users who tried to sign-up to your service, add the code to the JavaScript function which processes your sign-up form.

function register() {
     hj('tagRecording', ['Attempted Sign-up']);
     ...
}

Example 3: Tagging users who added a product to their cart and tagging the product they added

You may tag users who added a product to their cart and also tag the product they added by adding the JavaScript snippet to the function which processes items in your cart.

function addToCart(product) {
  	 hj('tagRecording', ['Added Product To Cart', product]);
     ...
}
 
addToCart('Product XYZ');
  

In the example above, we pass the "product" variable as the second parameter. This will result in your Recording being tagged with both "Added Product To Cart" as well as "Product XYZ"

Example 4: Tagging a user who signed up for your newsletter and opened your gallery

To track more than one event, you can use the JavaScript snippet multiple times.

function newsletterSignup() {
     hj('tagRecording', ['Signed-up to Newsletter']);
}
 
function openGallery() {
     hj('tagRecording', ['Browsed Gallery']);
}

The Recording will be saved with both tags: "Signed-up to Newsletter" and "Browsed Gallery".