This section is the starting point for upgrading an Exponential installation. Find the version you run, follow the path for it, and finish with the checks at the end of each guide. The current line is Exponential 6.0: the newest release is 6.0.14 (7 June 2026), and 6.0.15 is in development on the main branch.

An upgrade is safe when the kernel was never changed: your own work belongs in extensions, in settings/override/ and settings/siteaccess/, and in your own designs. Changes made directly to kernel files, the shipped settings or the shipped templates are overwritten by an upgrade; move them into an extension or an override first.

Find your version

In the administration, Setup > System information names the version. On the command line, from the installation root:

php bin/php/console --version

The database records its version in the table ezsite_data (the row names ezpublish-version and ezpublish-release keep their historic spelling on purpose).

Choose your upgrade path

eZ Publish was the predecessor of Exponential; its creator discontinued it, and Exponential continues its code. The upgrade pages of those years remain here as they were written, for sites that still have to climb that chain.

Always back up first

Take a backup of the database and of var/, settings/override/, settings/siteaccess/, extension/ and design/ before any upgrade, and restore it once on another machine to prove it works. Try every upgrade on a copy of the site before the live one. Backup and consistency checks explains the classic procedure; Upgrading to 6.0 gives the commands for every supported database.

The upgrade guides in the help center

The help center of every Exponential 6 installation carries the complete, maintained guides. They are also readable on this site:

• Updating Exponential 6.0: the short procedure from one 6.0.x release to a newer one, with rollback.
• Upgrading: from 4.x, 5.x or an earlier 6.0.x to today: every path, the database files per engine and the checklists per period of 6.0.
• Upgrading with the console: exp:upgrade: from 6.0.15, one command that shows, backs up, applies and verifies every upgrade step.
• The upgrade check: compare your files and database with the release before you upgrade.
• Changelog 6.0.15: what changed in the current line, and what to do about it.

Upgrade pages by version

Exponential 6.0

• Upgrading to 6.0
• Upgrading from 5.0 to 6.0 (the 2024 notes for sites moving from a 4.7 or 5.0 legacy stack)

eZ Publish 5.x

• Upgrading to 5.1: from 5.0 to 5.1, direct upgrading from 4.7 to 5.1
• Upgrading to 5.0: from 4.7 to 5.0

eZ Publish 4.x

• Upgrading to 4.7: from 4.6 to 4.7, direct upgrading from 4.1, 4.2, 4.3, 4.4 and 4.5 to 4.7
• Upgrading to 4.6: from 4.5 to 4.6, direct upgrading from 4.1, 4.2, 4.3 and 4.4 to 4.6
• Upgrading to 4.5: from 4.4 to 4.5, direct upgrading from 4.1, 4.2 and 4.3 to 4.5
• Upgrading to 4.4: from 4.3 to 4.4
• Upgrading to 4.3: from 4.2 to 4.3
• Upgrading to 4.2: from 4.1.x to 4.2
• Upgrading to 4.1: from 4.1.x to 4.1.y, from 4.0.x to 4.1.y
• Upgrading to 4.0: important notes, from 4.0.x to 4.0.y, from 3.10.x to 4.0.y

eZ Publish 3.x

• Upgrading to 3.10: from 3.10.x to 3.10.y, from 3.9.x to 3.10.y
• Upgrading to 3.9: from 3.9.x to 3.9.y, from 3.8.x to 3.9.0
• Upgrading to 3.8: from 3.8.x to 3.8.y, from 3.6.x or 3.7.x to 3.8.0
• Upgrading to 3.7: from 3.7.x to 3.7.y, from 3.5.2 to 3.7.0
• Upgrading to 3.6: from 3.6.x to 3.6.y, from 3.5.2 to 3.6.0
• Upgrading to 3.5: from 3.5.x to 3.5.y, from 3.4.4 to 3.5.0
• Upgrading to 3.4: from 3.4.x to 3.4.y, from 3.3-5 to 3.4.0
• Upgrading to 3.3: from 3.3-x to 3.3-y, from 3.2-4 to 3.3-1
• Upgrading to 3.2: from 3.2-x to 3.2-y, from 3.1-1 to 3.2-1
• Upgrading to 3.1: from 3.1-x to 3.1-y, from 3.0-2 to 3.1.0 rel1
• Upgrading to 3.0: from 3.0-1 to 3.0-2, from 2.9-7 to 3.0-1

Background for the classic releases

• How to proceed
• Direct upgrading
• Releases: the upgrade path from one branch to another
• Notes about database changes
• The system upgrade scripts (3.x)
• Upgrading from 3.a.b to 3.x.y

Getting help

Questions about an upgrade go to the Share Exponential forums; a bug goes to the issue tracker. For a production site on a deadline, 7x offers upgrade services. Getting Support lists every channel.