Submit Feedback

Updating Customizations

Plugins (e.g., themes, apps, and customizations) you’ve developed must be adapted to the new Liferay version. This can be as simple as updating dependencies or involve updating code to API changes. If you forgo updating your custom plugins, they may be disabled on the new Liferay version.

Upgrading on 7.4+

When upgrading your installation, you must also upgrade your customizations. This includes apps, services, configurations, and more. The steps to upgrade vary for each customization. Generally, the upgrade process follows these steps:

  1. Upgrade the Liferay workspace.

  2. Fix your project’s dependencies and deal with breaking changes. For a full list of deprecations and breaking changes, see Deprecations and Breaking Changes Reference.

  3. Upgrade Service Builder services.

  4. Upgrade customization plugins.

  5. In Liferay DXP/Portal 7.4, Liferay module language keys were moved to the Liferay Portal Language module. Many keys were renamed. Check if any of the language keys you’ve overridden have been renamed. For each renamed language key, use the new key name in your language.properties files. See Renamed Language Keys.

  6. Upgrade themes.

  7. Upgrade frameworks and features.

  8. Upgrade portlets.

  9. Update Marketplace apps. Skipping app updates can be problematic and can prevent the apps from enabling on the new Liferay version. Do this on your current installation before the database upgrade.

  10. Upgrade Marketplace app data. Some apps’ latest versions may have database schema changes that require data upgrades. You can upgrade the app data during or after your Liferay database upgrade.

    Note

    Alternatively, you can install the latest version of Marketplace apps after the database upgrade and use Gogo shell commands to upgrade the app data. See Post Upgrade Considerations for more app setup details.

  11. Migrate configurations and properties. You can wait until after the database upgrade to update your configurations and supporting infrastructure.

Upgrading on 7.3 or Lower

The Liferay Upgrade Planner is the recommended way to upgrade custom development to Liferay versions 7.2 and 7.3. It identifies your code that’s affected by breaking changes and offers to adapt your code automatically to many of the changes. See Upgrading Code to Liferay 7.2 for more information.

If you’re upgrading from 6.2 or earlier, update your file store configuration. See the Updating the File Store for more information.