General instructions for CUX snippet installation

Modified on Mon, 09 Oct 2023 at 05:06 PM

TABLE OF CONTENTS

Introduction

Installing the CUX snippet is quick, easy and can be completed in just a few minutes, enabling you to view the first recordings of your website's user behavior as soon as it's done. 

The snippet is essential for linking your website to CUX, ensuring that the database is always current and contains all the relevant visitor data, clicks, and visits. 


Before you start


Step by Step: Installing the CUX snippet manually

You can access the CUX snippet in two ways: during the creation of a new project or from an existing one.

1. After creating a new project, you’ll be guided through the project onboarding. After configuring all necessary parameters on step 5, you’ll see a snippet and instructions for its installation. Use a copy button to copy the entire snippet to your clipboard.



2. If you already have a project created, access the CUX platform and go to the project for which you want to install the snippet. Open project Settings and select the 'Integrate code' tab in the Settings menu. Locate the box containing the unique CUX snippet for the project. Click the snippet box - this will copy the entire snippet to your clipboard.


CUX snippet instalation from existing project

Remember that the CUX  snippet is unique to each project (website), so you will need to repeat these steps for every unique site you want to track with CUX.





3. Log in to your website's configuration panel and find the area where you can modify the website templates.


4. Choose the location in your websites template where you want to install the snippet. We recommend placing it before the closing BODY tag, but it can be installed anywhere on the page.


To get the best results from CUX, we strongly advise against installing the code on a single or selected pages, as you will miss out on valuable insights and the ability to observe the entire user journey. It's always best to install the CUX code for the entire site.


5. Paste the snippet that you copied from the CUX platform into the HTML template.

Here you have an example of how we did it on our website




6. Save the changes to your website and publish them if required.


7. Verify if the code works. 


To check if the snippet is functioning, open a few pages on your browser and go to the CUX dashboard. You will see the numbers appearing on the dashboard as soon as the code starts sending data to our database. If the code installation instructions were displayed upon logging in to CUX, they will disappear once we record the first visit and make it available for replay.



Congratulations on completing the CUX snippet installation! In just a few minutes, you can start viewing your website's user behaviour recordings and analysing the data. 


What's Next? 

  • Visits: Start investigating recordings & see what your users are actually doing on your pages. For a deeper understanding of the significance of visits for your business, read this article.

  • Heatmaps: Explore user behaviour on your website through visual heat maps that show what interests your users the most and what catches their eye. To learn more about heatmaps and their value, see Heatmap and How to Read a Heatmap?
  • Goals: Goals allow you to focus on data only relevant to your business goal – regardless if it's a purchase, form submission, file download, registration, go to checkout, clicks, scroll. For more in-depth information on Goals, please refer to our dedicated article on the topic.

What if the code is not working? 

Encountering issues with the CUX connection? Here are some steps you can take to troubleshoot:

  1. Visit one of the pages where you installed the CUX code. It's essential to record at least one visit to start showing data.

  2. Disable any ad-blocking browser extensions, such as Adblock. They may prevent the CUX snippet from sending user information.

  3. Check if the snippet has been correctly pasted on every page of your website. You can preview the source code of the page loaded in your browser and search for the "cuxSettings" string. If you find it in your page code, the code is installed and the data should be sent to CUX. If you're still not seeing any data in your CUX account, please contact us, and we'll guide you through the setup process.




Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select atleast one of the reasons

Feedback sent

We appreciate your effort and will try to fix the article