[Skip to main content](#vessel-content)

#  Matomo plugin

Details    Written by: Administrator    Category: [Pther extensions](/support/documentation/hikashop/other-extensions)     Published: 10 November 2026     Hits: 4

## Installation

1. You first need either Matomo installed on your own server (Matomo On-Premise) and configured, or a Matomo Cloud subscription.
2. Install the plugin with the Joomla extension manager, then publish it in the plugin manager (System - Hikashop Matomo).
3. Open the settings of the plugin and fill in the Site ID, the Matomo URL and an Auth token, then save.
4. In HikaShop, open System, Order statuses and tick, in the Matomo column, the statuses for which orders must be sent to Matomo. By default these are confirmed and shipped.

The plugin then adds the Matomo tracking to your pages, sends the product and category views and the cart, and sends each order from your server once it reaches a selected status.

## Configuration

![The Matomo settings](/images/doc/plugins/matomo/plg_system_matomo_settings.png)

- **Site ID**: the number of your website in Matomo. For a first website it is 1; it is shown in Websites, Manage in the Matomo administration. Default 1.
- **Matomo URL**: the address of your Matomo, shown in the integrations area of the Matomo dashboard. Without it nothing can be tracked.
- **Auth token**: a token created in the Matomo administration, in Personal, Security, Auth tokens. It lets your server send the orders. Without it the visits can still be tracked, but the orders are not recorded.

The order statuses are chosen in HikaShop, System, Order statuses, in the Matomo column. An order is sent once, when it reaches one of the selected statuses.

## Troubleshooting

- **Visits are tracked but sales do not appear**: check the Auth token first, then that the order reached one of the statuses ticked in the Matomo column.
- **A sale appears as a visitor of its own**: the order was created without a Matomo visitor id. This is the case for orders created in the backend and for visitors who block the tracking script.
- **"no visitor\_id in order ... for matomo purchase tracking"** (HikaShop log): the sale could not be attached to a visit, for the reason above. It is still sent.