Upgrading Liferay

Liferay is continuously being enhanced with new features as new versions are released. To access these features in your current project, you must upgrade your Liferay instance to a newer version. Upgrading is recommended in most cases as new Liferay versions have better performance, more tools and utility, and patch security vulnerabilities.

Liferay’s tools and instructions facilitate upgrading DXP and Portal environments safely and quickly. There are multiple ways to upgrade Liferay, so the best solution depends on multiple factors: if the environment is clustered (or sharded), the size of the data set, or the presence and extent of custom development. See Upgrade Basics for more information.

When upgrading a Liferay instance, there are best practices to ensuring the process happens quickly and smoothly. See Upgrade Stability and Performance to learn how to assure success when performing an upgrade. Also make sure to migrate all configurations and properties to the updated DXP or Portal instance.

When working with a new Liferay version, there are important changes to remember. Things like breaking changes, deprecations, and renamed language keys may cause problems if not properly addressed. Reference contains a comprehensive list of these changes to address when migrating an existing project to a new version.