Set up Qubit on Magento

In this article...

We'll cover the steps involved in implementing the Qubit Tracking extension in your Magento store.


This extension is compatible with Community and Enterprise versions 1.8, 1.8.1, 1.9, 1.9.1, 1.9.2, 1.9.3.


Before getting started, we recommend making a full backup of your Magento website. This is a good practice that should be followed before installation of any Magento modules. See Creating a Backup for more information.

Step 1

Navigate to the Magento Marketplace and enter Qubit in the search field provided. Then select Qubit Integration from the search results. Alternatively, navigate to Qubit Integration

Step 2

Add the extension to your cart and complete the checkout process. Once you have completed the order, select Install and copy the installation key. In our example, this is:

Step 3

Login to your Magento Administration Panel, then navigate to System > Magento Connect > Magento Connect Manager. Select the Extensions tab and paste the key you copied into the field provided

Select Install to complete the installation process

Step 4

Clear your cache, log out of the Administration Panel and log in again


Step 1

Login to the admin area for your Magento store. Typically, this is the URL specified during the installation of Magento, with the addition of /admin. Enter your admin username and password:

admin login

Step 2

Select System from the toolbar:


Then select Qubit > Qubit Tracking from the side menu:


Step 3

Configure the extension as required, referring to the following table as a guide:


Expected Value


Qubit Enabled


Whether to enable the Qubit Tracking extension for your Magento store

Emit Events


Whether to enable the emission of Qubit events for your Magento store

Tracking Id


The tracking Id for your property. This is provided by Qubit during onboarding.

If your property is hosted on multiple domains, typical for multi-language sites, then a tracking Id will be provided for each site. You will need to set up and configure the Qubit Tracking extension for each site



Which Qubit package you have purchased

There are differences between the events emitted by Qubit Aura and Qubit Pro

Smartserve URL


The URL of smartserve.js

This will be provided to you by Qubit

Smartserve Location

End of HEAD/End of BODY

The page location to inject smartserve.js

Smartserve Asynchronous


Whether to load smartserve asynchronously or not



The custom namespace, required to send custom events to Qubit

This will be provided to you by Qubit

Send Product Listing Events


Whether to emit events on product listing pages

Product Listing Event Limit


The maximum number of events that will be sent on product listing pages

Product Stock Data


Whether to include the product stock level in product events

Always Send Basket Events


Whether to send basket events on every page or just the checkout funnel

In the following example, we can see some of the configuration settings:

config settings

Known issues

For assistance in resolving these issues, please reach out to Customer Support at Qubit.


If your Magento store has a custom checkout functionality or plugin, the following events might be prevented from triggering:

  • ecBasketItem
  • ecBasketSummary
  • ecBasketItemTransaction
  • ecBasketTransactionSummary


When using the default minicart component minicart.js, it is possible that basket item events will not be sent, including:

  • ecBasketItem
  • ecBasketSummary

The Qubit Tracking extension rectifies this issue by extending the JavaScript object updateItem method.

If you are using a custom minicart implementation rather than the default minicart.js, you will need to replicate the logic to ensure basket item events are sent.

Configurable product

If your Magento store has a different configurable product implementation, with modifications in the default configurable.js file, and specifically the Product.Config.prototype.configureElement method, it is possible that the ecProduct event will not be sent when a visitor makes a product option selection.


If your Magento store has a different theme that is not using minicart.js and/or configurable.js files, it is likely that the issues reported above will be reproducible. For more information, reach out to your CSM at Qubit.

Last updated: January 2023
Did you find this article useful?