[comment]: # translation:outdated

[comment]: # aside:2

[comment]: # ({new-137ecc03})
# Upgrade notes for Zabbix 8.0

These notes are for upgrading from Zabbix 7.4.x to Zabbix 8.0.0.

All notes are grouped into:

-   **Breaking changes** - changes that may break existing installations and other 
    critical information related to the upgrade process
-   **Other** - all remaining information describing the changes
    in Zabbix functionality

See also: 

-   [Upgrade procedure](/manual/installation/upgrade) for all relevant information about upgrading from versions before Zabbix 8.0.0;
-   [Upgrading HA cluster](/manual/concepts/server/ha#upgrading-ha-cluster) for instructions on upgrading servers in a **high-availability** (HA) cluster.

[comment]: # ({/new-137ecc03})

[comment]: # ({new-2a68033f})
## Breaking changes

[comment]: # ({/new-2a68033f})

[comment]: # ({new-41aa18b8})
#### Database versions

The minimum [required database versions](/manual/installation/requirements#thirdparty-external-surrounding-software) have been raised:

-   MySQL/Percona: 8.0.30 → 8.4.0
-   MariaDB: 10.5.00 → 10.11.00
-   PostgreSQL: 13.0 → 15.0
-   TimescaleDB: 2.13.0 → 2.20.0

[comment]: # ({/new-41aa18b8})

[comment]: # ({new-0e0abe18})
#### Plugins

The Ceph plugin for Zabbix agent 2 is now a [loadable plugin](/manual/concepts/agent2/loadable-plugins) and requires additional installation steps.
See the Ceph plugin [readme](https://git.zabbix.com/projects/AP/repos/ceph/browse/README.md) for details.

The `tcp://` scheme is deprecated in the [MongoDB plugin](/manual/concepts/agent2/agent2_params_plugin/mongodb_plugin) but is kept for backward compatibility with existing configurations.

The `Plugins.Oracle.CallTimeout` parameter in the Oracle plugin [configuration file](/manual/concepts/agent2/agent2_params_plugin/oracle_plugin#plugins.oracle.calltimeout) no longer has any effect.
The maximum wait time is now determined by the [item timeout](/manual/config/items/item#item-timeout).

[comment]: # ({/new-0e0abe18})

[comment]: # ({new-b057aa6b})
#### Minimum required PHP version

The minimum required PHP version has been raised from 8.0.0 to 8.2.0.

[comment]: # ({/new-b057aa6b})

[comment]: # ({new-8c192b23})
#### Extended UnsafeUserParameters list

The `%` character has been added to the `UnsafeUserParameters` list for [Zabbix agent](/manual/concepts/agent/agentd_params_win#unsafeuserparameters) and [Zabbix agent 2](/manual/concepts/agent2/agent2_params_win#unsafeuserparameters).

[comment]: # ({/new-8c192b23})

[comment]: # ({new-afc94180})
#### Moved filter parameters

As part of the [customizable tables](/manual/whatsnew#customizable-tables) feature, some filter parameters have been moved from the filter tab to column options.
If you have saved [tabs for favorite filters](/manual/web_interface/frontend_sections/monitoring/problems#tabs-for-favorite-filters) that use any of the following filter parameters, they will be reset and must be reconfigured manually after the upgrade:

-   *Monitoring > [Hosts](/manual/web_interface/frontend_sections/monitoring/hosts)*: *Show suppressed problems*
-   *Monitoring > [Latest data](/manual/web_interface/frontend_sections/monitoring/latest_data)*: *Show tags*, *Tag name*, *Tag display priority*, *Show details*
-   *Monitoring > [Problems](/manual/web_interface/frontend_sections/monitoring/problems)*: *Show tags*, *Tag name*, *Tag display priority*, *Show operational data*, *Compact view*, *Show details*, *Show timeline*, *Highlight whole row*

[comment]: # ({/new-afc94180})

[comment]: # ({new-6fb2afb5})
#### JavaScript preprocessing: built-in object methods are now read-only

Built-in JavaScript object methods in [preprocessing](/manual/config/items/preprocessing/javascript) scripts are now read-only.
If you have already modified built-in methods on JavaScript prototypes in item preprocessing scripts, you may encounter issues, as modifying built-in prototype methods is no longer allowed.

[comment]: # ({/new-6fb2afb5})

[comment]: # ({new-c2d0e7e3})
#### MySQL database character set and collation

If the Zabbix MySQL database was created with the utf8mb3 character set and utf8mb3_bin collation, it is strongly recommended to convert it to utf8mb4 character set and utf8mb4_bin collation before upgrading Zabbix, as described in [Repairing Zabbix database character set and collation](/manual/appendix/install/db_charset_coll).

[comment]: # ({/new-c2d0e7e3})

[comment]: # ({new-57e1557d})
## Other

[comment]: # ({/new-57e1557d})

[comment]: # ({new-90fa75cf})
#### Deprecated macros dropped

The support for the following [built-in macros](/manual/appendix/macros/supported_by_location) has now been dropped:

|Dropped|Use instead|
|------------|------------|
|`{ACK.DATE}`|`{EVENT.UPDATE.DATE}`|
|`{ACK.MESSAGE}`|`{EVENT.UPDATE.MESSAGE}`|
|`{ACK.TIME}`|`{EVENT.UPDATE.TIME}`|
|`{EVENT.ACK.HISTORY}`|`{EVENT.UPDATE.HISTORY}`|
|`{HOSTNAME<1-9>}`|`{HOST.HOST}`|
|`{IPADDRESS<1-9>}`|`{HOST.IP}`|
|`{PROFILE.*}`|`{INVENTORY.*}`|
|`{TRIGGER.COMMENT}`|`{TRIGGER.DESCRIPTION}`|
|`{TRIGGER.KEY}`|`{ITEM.KEY}`|
|`{STATUS}`|`{TRIGGER.STATUS}`|
|`{USER.ALIAS}`|`{USER.USERNAME}`|

[comment]: # ({/new-90fa75cf})

[comment]: # ({new-6129ed65})
#### Deprecated parameters for history storage providers

The following parameters have now been deprecated:

-   Zabbix server configuration file: `HistoryStorageDateIndex`, `HistoryStorageURL`, and `HistoryStorageTypes`.
    Please use the new [`HistoryProviders`](/manual/concepts/server/server_params#historyprovider) parameter instead.
-   Zabbix frontend configuration file: `$HISTORY`.
    Please use the new [`$HISTORY_PROVIDERS`](/manual/appendix/install/elastic_search_setup#configuring-zabbix-frontend) parameter instead.

Both new parameters let you choose the history storage provider: [Elasticsearch](/manual/appendix/install/elastic_search_setup#configuring-zabbix-server), [ClickHouse](/manual/appendix/install/clickhouse_setup#configuring-zabbix-server), or SQL (default).
Note that you cannot use these new and deprecated parameters together.

[comment]: # ({/new-6129ed65})

[comment]: # ({new-ed613b06})
#### Removed JSON and XML validation from HTTP agent items

JSON and XML validation has been removed from the *Request body* field in [HTTP agent](/manual/config/items/itemtypes/http#configuration) items.
The field no longer checks whether the value is valid XML or JSON, and selecting *XML data* as the *Request body type* no longer requires the libxml2 library.

[comment]: # ({/new-ed613b06})

[comment]: # ({new-5a21ffae})
#### Disabled links hidden in monitored hosts

Disabled *Graphs*, *Dashboards*, and *Web* links are no longer displayed in the list of [monitored hosts](/manual/web_interface/frontend_sections/monitoring/hosts).

[comment]: # ({/new-5a21ffae})

[comment]: # ({new-d85f9729})
#### JSON data type

Zabbix now supports JSON as a [data type](/manual/config/items/item#configuration) for item values.
If you are using TimescaleDB, the new `history_json` hypertable (used to store JSON values) must be [configured manually](/manual/appendix/install/timescaledb#upgrading-timescaledb-schema).
If you are using Elasticsearch, the default value of the [`HistoryStorageTypes`](/manual/concepts/server/server_params#historystoragetypes) Zabbix server configuration parameter now includes `json`.

[comment]: # ({/new-d85f9729})

[comment]: # ({new-92484479})
#### Removed radio button in the New tag filter form

The radio button that required choosing between *All tags* and *Tag list* when [creating a new tag filter](/manual/config/users_and_usergroups/usergroup#configuration) has been removed.

[comment]: # ({/new-92484479})

[comment]: # ({new-de93e3a2})
#### Item values displayed as HTML using iframes

Item data in the [Item history](/manual/web_interface/frontend_sections/dashboards/widgets/item_history) widget, when displayed as HTML-formatted text, is now isolated in iframes.

[comment]: # ({/new-de93e3a2})

[comment]: # ({new-0be3c44c})
#### Template compatibility with Host Wizard

All out-of-the-box templates are now compatible with the [Host Wizard](/manual/config/hosts/host_wizard).
To upgrade them, see [Template upgrade](/manual/config/templates_out_of_the_box#template-upgrade).

[comment]: # ({/new-0be3c44c})

[comment]: # ({new-8229430b})
#### Autoresizing for configuration fields

Most configuration fields in the UI now automatically resize to fit their content.

[comment]: # ({/new-8229430b})

[comment]: # ({new-b9bebba9})
#### Replaced frontend configuration variable

The `$ALLOW_HTTP_AUTH` variable has been replaced by the `$ZBX_FEATURE_FLAGS['http_auth_enabled']` feature flag in the [frontend configuration file](/manual/installation/frontend#install) (`zabbix.conf.php`).

[comment]: # ({/new-b9bebba9})

[comment]: # ({new-e5345a30})
#### Concurrent processing of SNMPv1 and SNMPv2 checks

SNMPv1 and SNMPv2 asynchronous service checks are now processed concurrently by available discovery workers.

[comment]: # ({/new-e5345a30})

[comment]: # ({new-af4e2c17})
#### Changes to the Zabbix SELinux policy package

For version 10 of AlmaLinux, CentOS Stream, RHEL, Rocky Linux, and Oracle Linux, the existing `zabbix-selinux-policy` package now has a dependency on either `zabbix-selinux-policy-main` or `selinux-policy-targeted-extra`.<br>
If you have existing `zabbix-selinux-policy` installation, no manual changes are required.
During package upgrade, `zabbix-selinux-policy-main` will be installed automatically.
If `selinux-policy-targeted-extra` is already installed, no additional package will be installed.

[comment]: # ({/new-af4e2c17})

[comment]: # ({new-826a1031})
#### Renamed maintenance period state

The [maintenance](/manual/web_interface/frontend_sections/data_collection/maintenance) period state has been renamed from *Approaching* to *Upcoming*.

[comment]: # ({/new-826a1031})

[comment]: # ({new-5eb5233a})
#### Deprecated dashboard slideshow parameter

Support for the `slideshow=1` parameter will be removed.
New values for the `slideshow` parameter have been introduced to start and stop the slideshow:

-   `slideshow=on` - start the slideshow
-   `slideshow=off` - stop the slideshow

[comment]: # ({/new-5eb5233a})