CMS extension

Install Hitsteps on Joomla 5 and 6

The Joomla package includes the Hitsteps component, plugin, and modules. Version 3 uses native Joomla services and events, upgrades existing Hitsteps settings in place, and does not need a compatibility plugin.

Guide version

Joomla 5 and 6

This is the current guide for the native Joomla 5/6 extension. Joomla 2, 3, and 4 use the archived guide.

Version3.0.0
Last update3 August 2026
CompatibilityJoomla 5 and 6

Before you start

Joomla administrator access
The downloaded Hitsteps Joomla package
Your Hitsteps API key
Joomla 5 and 6 installation
1

Open Extensions installer

In Joomla administrator, open System from the left sidebar. Under Install, choose Extensions.

Open Extensions installer
2

Upload the package

Drop the downloaded Hitsteps extension into the upload area or choose the file manually.

Upload the package
3

Open Plugins

After installation succeeds, go back to System and open Plugins under Manage.

Open Plugins
4

Configure Hitsteps

Find the Hitsteps plugin, paste your API key, enable the plugin, and save the changes.

Configure Hitsteps
5

View the four widgets

Open Components, then Hitsteps Analytics, to see the analytics summary, Online Visual, recent visitors, and visitor map. The same four widgets appear on the administrator dashboard.

View the four widgets
6

Verify live tracking

Open your public website in another browser tab, then confirm that your visit appears in the Hitsteps live dashboard.

Upgrade from legacy v2.08
1

Back up Joomla

Create a current site and database backup before changing extensions.

2

Install v3.0.0 over v2.08

Upload the new package without uninstalling v2.08 first. Joomla upgrades the existing component, plugin, and modules in place.

3

Confirm your settings

Open the Hitsteps plugin and confirm that the API key, language, privacy choices, and module assignments were preserved.

4

Test without compatibility mode

Disable Joomla compatibility plugins, clear cache, and verify the public site and administrator before removing your backup.

Uninstall from Joomla
1

Open managed extensions

Open System, then Extensions under Manage, and search for Hitsteps Analytics Package.

2

Uninstall the package

Select the Hitsteps Analytics package and click Uninstall. Joomla removes its component, plugin, modules, media, and update-site records together.