Matomo › Update

Matomo database will be upgraded from version 4.16.0 to the new version 5.3.1.

The following plugins will be updated: TagManager.

The following dimensions will be updated: log_conversion.pageviews_before.

Important notes for large Matomo installations

If you have a large Matomo database, updates might take too long to run in the browser. In this situation, you can execute the updates from your command line:

php /var/www/matomo/console core:update

If you manage a high traffic Matomo server, we recommend to momentarily disable visitor Tracking and put the Matomo User Interface in maintenance mode.

FYI: these are the SQL queries and console commands that will be executed to upgrade your database to Matomo 5.3.1

› Click here to view and copy the list of SQL queries and console commands that will get executed

# These SQL queries will be executed: 
DELETE FROM `matomo_archive_numeric_2020_01` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2020_01` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2020_01` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2020_02` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2020_02` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2020_02` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2020_03` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2020_03` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2020_03` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2020_04` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2020_04` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2020_04` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2020_05` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2020_05` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2020_05` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2020_06` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2020_06` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2020_06` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2020_07` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2020_07` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2020_07` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2020_08` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2020_08` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2020_08` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2020_09` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2020_09` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2020_09` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2020_10` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2020_10` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2020_10` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2020_11` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2020_11` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2020_11` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2020_12` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2020_12` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2020_12` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2021_01` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2021_01` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2021_01` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2021_02` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2021_02` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2021_02` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2021_03` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2021_03` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2021_03` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2021_04` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2021_04` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2021_04` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2021_05` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2021_05` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2021_05` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2021_06` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2021_06` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2021_06` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2021_07` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2021_07` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2021_07` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2021_08` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2021_08` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2021_08` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2021_09` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2021_09` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2021_09` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2021_10` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2021_10` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2021_10` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2021_11` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2021_11` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2021_11` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2021_12` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2021_12` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2021_12` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2022_01` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2022_01` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2022_01` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2022_02` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2022_02` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2022_02` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2022_03` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2022_03` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2022_03` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2022_04` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2022_04` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2022_04` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2022_05` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2022_05` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2022_05` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2022_06` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2022_06` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2022_06` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2022_07` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2022_07` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2022_07` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2022_08` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2022_08` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2022_08` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2022_09` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2022_09` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2022_09` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2022_10` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2022_10` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2022_10` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2022_11` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2022_11` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2022_11` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2023_01` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2023_01` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2023_01` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2023_06` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2023_06` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2023_06` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2023_07` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2023_07` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2023_07` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2023_08` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2023_08` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2023_08` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2023_09` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2023_09` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2023_09` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2023_10` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2023_10` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2023_10` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2023_11` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2023_11` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2023_11` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
ALTER TABLE `matomo_user_token_auth` ADD COLUMN `post_only` TINYINT(2) UNSIGNED NOT NULL DEFAULT '0';
ALTER TABLE `matomo_log_conversion` ADD COLUMN `pageviews_before` SMALLINT UNSIGNED DEFAULT NULL;

# These console commands will be run: 
./console core:calculate-conversion-pages --dates=yesterday,today

# These SQL queries will be executed: 
ALTER TABLE `matomo_log_visit` ADD INDEX `index_idsite_idvisitor_time` (`idsite`, `idvisitor`, `visit_last_action_time` DESC);
ALTER TABLE `matomo_log_visit` DROP INDEX `index_idsite_idvisitor`;

# These console commands will be run: 
./console plugin:activate "JsTrackerInstallCheck"

# These SQL queries will be executed: 
ALTER TABLE `matomo_user_token_auth` CHANGE `post_only` `secure_only` TINYINT(2) UNSIGNED NOT NULL DEFAULT '0';
ALTER TABLE `matomo_user` ADD COLUMN `ts_changes_shown` TIMESTAMP NULL;

# These console commands will be run: 
./console config:set --section="database" --key="collation" --value="utf8mb4_general_ci"
./console config:set --section="database" --key="collation" --value="utf8mb4_general_ci"
./console core:invalidate-report-data --dates=2025-04-01,today --plugin=Actions.Actions_hits

# These SQL queries will be executed: 
ALTER TABLE `matomo_archive_invalidations` ADD COLUMN `processing_host` VARCHAR(100) NULL DEFAULT NULL, ADD COLUMN `process_id` VARCHAR(15) NULL DEFAULT NULL;

# These console commands will be run: 
./console featureflags:delete ImprovedAllWebsitesDashboard

# These SQL queries will be executed: 
ALTER TABLE `matomo_tagmanager_container` ADD COLUMN `ignoreGtmDataLayer` TINYINT(1) UNSIGNED NOT NULL DEFAULT 0 AFTER `description`;
ALTER TABLE `matomo_tagmanager_container` ADD COLUMN `isTagFireLimitAllowedInPreviewMode` TINYINT(1) UNSIGNED NOT NULL DEFAULT 0 AFTER `ignoreGtmDataLayer`;
ALTER TABLE `matomo_tagmanager_container_version` CHANGE `name` `name` VARCHAR(255) NOT NULL DEFAULT '';
ALTER TABLE `matomo_tagmanager_container` CHANGE `name` `name` VARCHAR(255) NOT NULL;
ALTER TABLE `matomo_tagmanager_tag` CHANGE `name` `name` VARCHAR(255) NOT NULL;
ALTER TABLE `matomo_tagmanager_trigger` CHANGE `name` `name` VARCHAR(255) NOT NULL;
ALTER TABLE `matomo_tagmanager_variable` CHANGE `name` `name` VARCHAR(255) NOT NULL;
ALTER TABLE `matomo_tagmanager_container` ADD COLUMN `activelySyncGtmDataLayer` TINYINT(1) UNSIGNED NOT NULL DEFAULT 0 AFTER `ignoreGtmDataLayer`;
ALTER TABLE `matomo_tagmanager_container` CHANGE `activelySyncGtmDataLayer` `activelySyncGtmDataLayer` TINYINT(1) UNSIGNED NOT NULL DEFAULT 1;
ALTER TABLE `matomo_tagmanager_container_version` CHANGE `name` `name` VARCHAR(255) NOT NULL DEFAULT '';
ALTER TABLE `matomo_tagmanager_container` CHANGE `name` `name` VARCHAR(255) NOT NULL;
ALTER TABLE `matomo_tagmanager_tag` CHANGE `name` `name` VARCHAR(255) NOT NULL;
ALTER TABLE `matomo_tagmanager_trigger` CHANGE `name` `name` VARCHAR(255) NOT NULL;
ALTER TABLE `matomo_tagmanager_variable` CHANGE `name` `name` VARCHAR(255) NOT NULL;
ALTER TABLE `matomo_log_conversion` ADD COLUMN `pageviews_before` SMALLINT UNSIGNED DEFAULT NULL;

Need help upgrading Matomo?

If you need support to upgrade your Matomo, the creators of Matomo are here to help you make the Matomo upgrade a success and provide all instructions, best practises and ongoing support. Contact the Matomo experts to get started upgrading your Matomo safely.

Ready to go?

The database upgrade process may take a while, so please be patient.

File integrity check failed and reported some errors. You should fix this issue and then refresh this page until it shows no error. Details

Database Upgrade Required

Important notes for large Matomo installations

Need help upgrading Matomo?

Ready to go?