Submit Feedback
Legacy Knowledge Base
Published Sep. 10, 2025

Requires 3.0 opt-in when customizing Control Panel

Written By

Aurél Förstner

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.

Issue

  • When deploying a module that customizes Control Panel, the changes don't take effect and I get: 
    java.lang.UnsupportedOperationException: Requires 3.0 opt-in.

Environment

  • Liferay DXP 7.2

Resolution

The solution is to rebuild the module with the latest Liferay IDE version as well as the latest Blade version:

  1. If you do not already using the Liferay Developer Studio, you can install it following this article: Installing Liferay Developer Studio 3.9.x (check latest Developer Studio releases in the Downloads page.
  2. If you are already using the Developer Studio, you can upgrade it according to this article: Updating Liferay Dev Studio
  3. Here is the article for upgrading the Blade CLI version: Updating the Blade CLI.
  4. And after the above steps, when you are on the latest Dev Studio and Blade versions, you can follow the below steps to import your modules:
    • If you modules are not residing in a Liferay Workspace or you want to import the whole Workspace: Importing Projects in Dev Studio
    • If you want to import individual modules into a new Workspace from an existing workspace, you can copy them into the modules folder of the Workspace in Developer Studio. 
Did this article resolve your issue ?
Legacy Knowledge Base
Did this article resolve your issue ?