Legacy Knowledge Base
Published Jul. 2, 2025

Theme embedded portlets cannot be configured in Content Pages

Written By

Kanchan Bisht

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

  • The portlet cannot be edited.
  • Steps to reproduce:
    1) Setup 7.2 vanilla with latest FP, start the server
    2) Create a minimal theme 'my-liferay-theme' with yo liferay-theme
    3) cd into the root folder of the theme and run gulp build
    4) Copy over portal_normal.ftl from my-liferay-theme/build/templates into my-liferay-theme/src/templates (create the templates directory if missing)
    5) Edit my-liferay-theme/src/templates/portal_normal.ftl and add this snippet in the content section:
    <@liferay_portlet["runtime"]
    portletName="com_liferay_journal_content_web_portlet_JournalContentPortlet" />
    (https://help.liferay.com/hc/en-us/articles/360028746512-Embedding-a-Portlet-by-Portlet-Name)
    6) Compile the theme with gulp build and deploy my-liferay-theme/dist/my-liferay-theme.war to liferay/deploy folder
    7) Create a Content Page in Liferay
    8) On the Content page, at the right-side toolbar, navigate to Look and Feel > Define a specific look and feel for this page > Change Current Theme > My Liferay Theme > Save
    9) Web Content Display onto the page can be seen. Hover the mouse over it to attempt editing it (e.g. selecting a web content to be displayed)
    Expected Behavior: The portlet to be editable
    Observed Behavior: A message on the interface will pop-up and it won't be possible to change the configuration.
    This area is defined by the theme. To change theme settings go to the Look and Feel configuration in the sidebar.

Environment

  • Liferay DXP 7.2

Resolution

  • The observed behavior is a known issue in DXP 7.2 fix-pack-12 and lower versions, however, fix-pack-13 addresses it.

Additional Information

Did this article resolve your issue ?

Legacy Knowledge Base