How to Tag your Hotjar Recordings

Tagging your Recordings allows you to note specific actions, like CTA clicks, sign-ups, or visitor states. Once Recordings have been tagged, you can then filter by tag in your Recordings dashboard.

You can tag Recordings in two ways:

• Tagging Manually: within the Hotjar Recordings player.
• Tagging Automatically: by installing a JavaScript snippet on your site. This is only available to accounts on the Hotjar Plus plan or above.

---

How to Tag Recordings Manually

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.

Back to top

How to Tag Recordings Automatically

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".

If there is a chance that the code will be run before the Hotjar script has loaded, you must add this line of code just before:

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

If you add the same tag on multiple pages, Hotjar will automatically detect the duplicates and only save one tag.

The tags can be any alphanumeric value you like including spaces, e.g. 'Checkout Page'. The Recording will fail to tag if it has more than 250 characters.

A single Recording can have no more than 50 tags. Any additional tags will be ignored.

Back to top

---

Examples of Automatic Tagging

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".

Back to top