Legacy Knowledge Base
Published Sep. 10, 2025

Liferay Upgrades: Updating Custom Plugins

Written By

Brett Ripley

How To articles are not official guidelines or officially supported documentation. They are community-contributed content and may not always reflect the latest updates to Liferay DXP. We welcome your feedback to improve How To articles!

While we make every effort to ensure this Knowledge Base is accurate, it may not always reflect the most recent updates or official guidelines.We appreciate your understanding and encourage you to reach out with any feedback or concerns.

Legacy Article

You are viewing an article from our legacy "FastTrack" publication program, made available for informational purposes. Articles in this program were published without a requirement for independent editing or verification and are provided"as is" without guarantee.

Before using any information from this article, independently verify its suitability for your situation and project.

The following article describes how to update plugins to be compatible with a new version of the Liferay platform.

Resolution

The Liferay API may change from release to release, causing issues when trying to port code to a new version of Liferay. Please follow these steps in order to begin updating your plugins to be compatible with a new version of the Liferay platform.

  1. Download the Plugins SDK for the version of Liferay you are migrating to
  2. Copy your code and resources to the new Plugins SDK
  3. Review documentation to better understand how the API has changed in the new version of Liferay (see below)
  4. Implement API changes as needed to your existing code
  5. Compile and test

At this point, you may need to address several issues, depending on what is indicated by the compiler or in testing, in order to make the plugin work as intended and be compatible with the new version.

Helpful Articles for Updating Plugins

Known Issues Encountered When Updating Portlets

Did this article resolve your issue ?

Legacy Knowledge Base