Site Search - Liferay Learn

CAPTCHA is not refreshing in Sign-In popup on Sign-In page

Issue CAPTCHA is not refreshing in the sign-in pop-up page. If the user is already on the sign-in page and opens the sign-in form from the pop-up, the CAPTCHA does not refresh properly in the pop-up. Steps to reproduce: Deploy the jar file by overriding the Liferay login page by...

Activity within embedded pages does not maintain user sessions

legacy

Issue Activity within an application found on a Liferay embedded page does not count as activity with regard to a Liferay session, so it does not maintain the user session. As a result, the user is session expires after the appropriate timeout period Environment Quarterly Release...

One cluster node doesn't start up completely after OS patching

legacy Troubleshooting

Issue I am currently running a Liferay cluster. I patched my OS then rebooted each server separately. One more more nodes came back online correctly, but at least one node isn't starting up completely, and I see messages like this in the logs (this WARN will only show up if you're below...

Workflow "Metrics" Data Not Visible After Upgrading Liferay

legacy Troubleshooting

Issue After upgrading Liferay from 2024.Q2.7 to 2025.Q1.4-lts, navigated to Applications Menu > Applications > Workflow > Metrics, and noticed that the data is not being displayed. Steps to reproduce: Start Liferay 2024.Q2.7. Apply 'Single Approver' workflow to a Web Content (or another...

Feature Flags are not enabled by Default

legacy Troubleshooting

Issue I have an issue with the feature flags: feature.flag.LPD-11131=true and feature.flag.LPD-35013=true I set both features in the portal-ext.properties file in 2025.q1.6-lts. However, after started the instance the features are not enabled by default. The Wiki and Message boards...

Authenticated users with no permission to access Control Panel can navigate to /control_panel/manage with the message: Please select a tool from the left menu.

legacy

Issue I have an issue with authenticated users who do not have privilege to access the Control Panel. A user with no specific role (Only User role), when navigating to /control_panel/manage gets redirected to a page with the message: Please select a tool from the left menu. Reproduction...

Exceptions in the log when the Glowroot page times out

legacy Troubleshooting

Issue I see a lot of exceptions in the Glowroot logfile. It is caused by administrators accessing the glowroot page and leaving it open in a tab. Then the session times out and since the frontend tries to update the view in a loop, it produces a lot of exceptions till the tab is closed....

Upgrade report was not generated because no upgrade processes were executed

legacy

Issue After upgrading the database and during the server restart, the following can be seen: 2025-04-20 19:42:34.547 INFO [main][UpgradeRecorder:156] No pending upgrades to run 2025-04-20 19:42:34.553 INFO [main][UpgradeReport:96] Upgrade report was not generated because no upgrade...

Setting up Session Timeout in your Liferay environment with WebLogic

legacy How To

Issue How to set up Session Timeout in your Liferay environment with WebLogic? Environment Liferay DXP 7.3+ Resolution The Session Timeout can be defined in web-app/web.xml file within session-config like the following: <session-config> <session-timeout>30</session-timeout>...

Reindexing Errors and Warnings After Upgrade

legacy Troubleshooting

Issue After upgrading Liferay, reindexing throws errors and warnings in the logs. Liferay starts up successfully, and the database upgrade finished without errors. Errors: 2025-04-15 11:58:36.632 ERROR [default-7][jericho:211] StartTag a at (r2851,c9,p28171) has missing whitespace after...

Libraries/tools used to minify DXP code in build time

legacy

Issue What are the libraries/tools used to minify DXP code in build time (we are studying the possibility of using the same toolbox for our own developments). Environment Liferay DXP Resolution Liferay DXP uses esbuild , so that’d be our recommendation. Additional Information esbuild -...

Unable to migrate content from Dynamic Data Lists to Objects using the Data Migration Center

legacy Troubleshooting

Issue Unable to migrate content and data from Dynamic Data Lists through the Data Migration Center due to issues found during the process. Environment DXP 2023.Q4+ Portal GA102+ Resolution The Data Migration Center is a Beta Feature, and therefore not fully supported until released. The...

How to grant access to Analytics Cloud members for members of a Liferay internal portal?

legacy How To

Issue Could you please guide me how to grant access to Analytics Cloud for internal members of our Liferay portal? Environment Analytics Cloud Resolution Generally speaking, the new users have to log in to analytics.liferay.com using their Liferay account. If they don’t have any, they...

Multiple Performance Issues Identified via Lighthouse, Google Insights and Web Audit Tools

legacy How To

Issue How do I increase site performance with Lighthouse, Google Insights and Web Audit Tools? Environment Quarterly Releases DXP 7.0 DXP 7.1 DXP 7.2 DXP 7.3 DXP 7.4 Resolution Firstly, please note that Liferay does not have any official commitments with third-party analytics tools such...

How can you ensure that users from User Groups are properly imported when using LDAP Active Directory with Liferay?

legacy Troubleshooting

Issue Ensuring that User-Groups users are properly imported when using LDAP Active Directory with Liferay. Environment Liferay DXP 7.4 Resolution To ensure proper user imports and updates, the User Group names in LDAP Active Directory must match those in Liferay. Additional Information...

Warning in logs: "No theme found for specified theme id" after uninstalling a theme

legacy Troubleshooting

Issue After migrating, the following warning appears in the logs: 2025-05-19 08:51:53,593 WARN [ajp-nio-10.10.13.111-8009-exec-83][ThemeLocalServiceImpl:220] No theme found for specified theme id yourOld_WAR_theme. Returning the default theme. The theme yourOld_WAR_theme was uninstalled...

Error in Logs When Accessing "OAuth 2 Administration" in Control Panel

legacy Troubleshooting

Issue When clicking on the "OAuth 2 Administration" option in the Control Panel, the following error is logged, and the UI displays an unresolved Velocity variable (${processor.processMax()}): Unable to execute method processMax...

Error Code 403 Forbidden: Timeout Issues when uploading/downloading Large Files to S3

legacy Troubleshooting

Issue Experiencing timeout and permission issues when uploading/downloading large files (in GBs) using Liferay's simple file system. ERROR [http-nio-0.0.0.0-8080-exec-41][PortletServlet:109] Unable to process portlet com_liferay_document_library_web_portlet_DLAdminPortlet:...

Workflows are missing from Applications → Process Builder

legacy Troubleshooting

Issue Some workflows are missing from Applications → Process Builder. I have publications enabled in my environment, and I have edited workflows from withing the publications. Environment Quarterly Releases Resolution Currently, if a workflow is edited from a publication, it will only be...

Document Checkin and Cancel Checkout fails when using Office 365

legacy Troubleshooting

Issue When I try to check a document in or cancel checkout, it always fails on the first attempt. I see these errors in the logs com.liferay.portal.kernel.log.LogSanitizerException: com.microsoft.graph.http.GraphServiceException: Error code: notAllowed_Error message: The resource you...

Configuring the "Module Definition Timeout"

legacy How To

Issue We needed to programmatically configure the "Module Definition Timeout (seconds)" setting found under System Settings > Infrastructure > JavaScript Loader in the Liferay UI. Specifically, we were looking for a way to set this value using a system property or configuration file,...

After changing image file extension it is no longer visible for selection within a fragment

legacy Troubleshooting

Issue Our team recently noticed that they can't use PNG files anymore and can reproduce it by: Upload PNG file to Documents and Media library (please note that after page refresh Liferay does not show an image preview) Go to any Content Page and click Edit Drag and drop and image...

Sites/Groups Not Searchable in Out-of-the-Box Liferay

legacy

Issue We do not see sites as an option while selecting different asset types in the Type Facet portlet as well as in Blueprint configuration. However, we can see in the Liferay source code that SiteAssetRendererFactory is created. We want groups to be part of the search results when...

Welcome to Liferay converted to a random paragraph when using non-US English language

legacy

Issue When using English (United Kingdom), English (Australia), or English (Canada) as the default language in Liferay DXP page, the default page displays a placeholder message instead of the expected "Welcome to Liferay." A paragraph is a self-contained unit of a discourse in writing...

Users are redirected to the Document Library home folder after interacting with a document

legacy Troubleshooting

Issue After interacting with a document in a sub-folder withing the Document Library, users are redirected back to the Document Library's home folder. Environment Quarterly Releases Resolution This issue has been resolved by LPD-54503. To fix this issue, upgrade to an update the includes...

Error uploading file: ClassCastException: class com.liferay.portal.repository.liferayrepository.model.LiferayFileEntry cannot be cast to class com.liferay.portal.kernel.model.BaseModel

legacy Troubleshooting

Issue I get an error like this in the logs when uploading a file: Caused by: java.lang.ClassCastException: class com.liferay.portal.repository.liferayrepository.model.LiferayFileEntry cannot be cast to class com.liferay.portal.kernel.model.BaseModel...

Changes to Site Templates are not propagated to pages

legacy Troubleshooting

Issue Changes made to a site template are not propagated to the pages that use the template. We can see the next error in the server log: [LayoutSetPrototypeMergeBackgroundTaskExecutor:219] Merge fail count increased to 1 for layout set prototype 11111...

Is there a way to customize URLs by Web Content Structures?

legacy How To

Issue We would like to know if there is a way to customize URLs by web content structure for SEO purposes. Currently, friendly URLs for web content use the /w/ separator, which can be customized since 2024.Q2. See Configuring Friendly URL Separators . However, there is a need to further...

learn-resources.liferay.com:443: Connection reset lines appearing in logs

legacy Troubleshooting

Issue The following warnings have been appearing in the Liferay logs and need to be removed: INFO [http-nio-8080-exec-2][RetryExec:97] I/O exception (java.net.SocketException) caught when processing request to {s}->https://learn-resources.liferay.com:443: Connection reset INFO...

Form Rules Only Apply on Preview

legacy Troubleshooting

Issue Form rules don't work when the form is placed on a page, but they do work correctly when previewing the form. Environment DXP 2024.Q4, 2025.Q1 Resolution This issue can happen when publishing a form without rules and then adding rules without saving the changes. When the form is...

CVE-2025-2565

legacy Troubleshooting

Issue We would like to know if we are affected by CVE-2025-2565. Environment DXP 7.4, Quarterly Release, 2023.Q4, 2023.Q4, 2024.Q1, 2024.Q2 Resolution Review Liferay's documentation for 2025-2565 to see if your current version is affected. If it is, please request a hotfix that contains...

Unable to get session state in 7.4 with call that worked in 7.2

legacy How To

Issue When trying to use Liferay.Session to get the session state I get a null value (utilizing specifically javascript and call Liferay.Session.get("sessionState") and the below error. This worked in 7.2, but does not in 7.4. VM172:1 Uncaught TypeError: Cannot read properties of...

Configuring OAuth2 for Message Board Mailing Lists

legacy How To

Issue Basic authentication for emails is no longer available for Gmail, can we use OAuth2 connection with them? Google Workspace has announced that third-party apps that use only a password to access Google Accounts will no longer be supported, what does that mean for our users?...

Publication to live fails with an error like "Portlet export failed for portlet com_liferay_exportimport_web_portlet_ChangesetPortlet com.liferay.exportimport.kernel.lar.PortletDataException: No Layout exists with the primary key xxxxx"

legacy Troubleshooting

Issue Publication to live fails with an error like: 2025-04-24 13:42:15.663 ERROR [liferay/background_task-8][LoggerExportImportLifecycleListener:226] Portlet export failed for portlet com_liferay_exportimport_web_portlet_ChangesetPortlet...

Liferay Dropdown Functionality isn't working properly

legacy Troubleshooting

Issue We've discovered an undesirable behavior when using the Liferay drop-down menu. Steps to reproduce: Content Page > Edit > Insert a "HTML" fragment and double click on the fragment Attach the following html markup within the HTML fragment editor <div class="row"> <div class="col">...

Can't to edit files in Google Drive or Office 365 in non-production publications

legacy Troubleshooting

Issue When I try to edit a document through Google Drive or Office 365 in a non-production publication, I see a notification in the UI that says "Error: This action can only be performed in production mode." Additionally, I'm unable to cancel document checkouts from non-production...

Unable to Publish Web Content with Error "RangeError: Invalid time zone specified"

legacy Troubleshooting

Issue After upgrading to 2025.Q1.5, any user with the time zone (UTC +10:00) Australian Eastern Standard Time is unable to publish Web Content. After clicking Publish with Permissions, the user remains on the same page, and the publish button disappears. The following error is present...

How to Connect Documents and Media to a Local File System Using a WebDAV URL

legacy How To

Issue Steps to connect the WebDAV URL with your local machine's file system. Environment DXP 7.4 and above DXP 2023.Q4.0 and above Resolution For Fedora and Linux Machines (Before 2023.Q4.0): Navigate to Documents and Media. Click the ⋮ (Options) icon in the top-right corner > select...

AntiSamyモジュールを無効化しても、Webコンテンツにタグを貼り付けた際、属性が自動的に削除される

legacy Troubleshooting

問題 Webコンテンツを編集時に、タグを貼り付けると、タグの属性が自動的に削除されてしまいます。一例として、 <p oncontextmenu="return false;">Test</p> をペーストすると、 <p>Test</p> に自動的に変更されます。 Webコンテンツの入力のサニタイズは、AntiSamyモジュールにより行われているのは既知だが、 AntiSamyモジュールを無効化しても、動作が変わりません。どの様に、上記のようなサニタイズを無効化できますでしょうか。環境 DXP Quarterly Releases 解決...

Intermittent Digit Loss in Liferay Form Confirmation Field

legacy Troubleshooting

Issue I'm experiencing an issue where digits are unexpectedly removed when quickly typing numbers into a confirmation field within a Liferay Form. Steps to Reproduce: Create a new Liferay Form. Add a numeric field to the form. In the numeric field's Advanced configuration, enable the...

Resources Not Displaying Correctly in Page Fragments

legacy Troubleshooting

Issue Page fragments that use resources with Freemarker variables in their URLs do not display correctly when the fragment is viewed on a page. <#assign varResource = "resourceName"/> <img src="[resources:Header/${varResource}]"> Environment Liferay DXP 2025.Q1 Resolution To work...

Cannot Deploy a Portlet to a Widget Page

legacy Troubleshooting

Issue After deploying a portlet, I'm not able to move it to a widget page. Adding portlets from WAR fails due to the permission checking logic in UpdateLayoutStrutsAction javax.servlet.ServletException: com.liferay.portal.kernel.security.auth.PrincipalException$MustHavePermission: User...

PATCH Object Request Fails With Mandatory Vocabulary

legacy Troubleshooting

Issue When trying to perform a PATCH request on an object instance to update a field, if the object has a required vocabulary, the request fails with the following error: { "detail": "Select at least one taxonomy category for vocabulary <vocabulary_name>", "status": "BAD_REQUEST",...

Module/Theme data persists after undeploying it and clearing cache

legacy Troubleshooting

Issue After removing a deployable module, some of its data can persist despite clearing the cache which includes the osgi/state folder, and all temp and work directories. For example, after removing a custom theme, its JavaScript files get merged into the ComboJS URL:...

Unable to cast String to Long error during upgrade

legacy Troubleshooting

Issue When upgrading from Liferay DXP 7.2 to 2025.Q1, setting the fileMaxSize property in the com.liferay.document.library.configuration.DLConfiguration.config file causes an "Unable to cast String to Long" error. The upgrade tool fails with this error because the fileMaxSize property...

Changing the site logo

legacy How To

Issue How do I change my site's logo in 7.4? Environment 7.4 Resolution Open the Site Menu () and navigate to Site Builder → Pages. Click Options () in the Application Bar and select Configuration. Under Logo, click Change Logo (). Additional Information...

Erratic behavior when using pagination in Documents and Media

legacy Troubleshooting

Issue When listing documents in Documents and Media section, some files are missing or duplicated when using pagination. The same can happen in other sections as well, such as Web Content. Environment DXP 7.3 DXP 7.4 Quarterly Releases Resolution This can happen if the files have the...

"Missing 'Date Modified' and 'Date Created' Fields in Object Display Page Template Mapping

legacy Troubleshooting

Issue We have a Display Page Template defined for an Object (Documents - Simple Document). In the edit mode, in the list of available variables of the mapping fields, the Date Modified and Date Created fields are missing. How can we use these variables? Environment 2024.Q3.13 Resolution...

How do I renew expired SAML certificate?

legacy

Issue We just noticed while browsing through the admin settings that apparently our SAML certificate expired four months ago, but our SSO and login works with no issue. We use Azure AD (Entra) for the Identity Provider and are now curious then what this certificate is for as well as any...

Organization's users exposed in UI when modifying groupID in Request Body

legacy Troubleshooting

Issue An organization's member list can be seen by manipulating the role member assign(groupID) in a request. Here are the steps to reproduce: Setup browser proxy to 127.0.0.1:8180. For example with Chrome, navigate to Settings > System > Open your computer’s proxy settings Download,...

Fragments and Fragment Compositions Share Permissions

legacy

Issue We want to create a role where a user can have granular control of the layout of a page by creating and editing Fragment Compositions, but not the ability to create or edit fragments themselves, how can we accomplish this task? Users with only "View" permission for Fragments cannot...

How to map Liferay site roles with Azure AD

legacy How To

Issue How to map Liferay site roles to Azure AD roles when configuring SAML? For example, if there is a role called Content Author under site roles, how to configure this role in Azure AD? Environment Liferay DXP [all versions] Resolution As per the compatibility matrix, Liferay DXP Self...

Password Reset Link Breaks After Language Change

legacy Troubleshooting

Issue After adding users from the portal, users receive an email to create their account password. This email contains a password reset link. Clicking the password reset link opens a page to reset the password. If the language is changed on the page using the language toggle, an error...

Managing Temp Files in Tomcat

legacy Troubleshooting

Issue How temp files in Tomcat are handled? Do they get deleted automatically after the file upload is successful? Environment Liferay DXP 7.4 Resolution Temporary Files During Upload – Documents and Media: 1. When files are uploaded via the Documents and Media portlet in Liferay, they...

Dataset Column Widths Incorrect on Tab Change

legacy Troubleshooting

Issue When displaying multiple data sets on a page using the Tabs element, the columns break. They appear crammed to the left side, the columns are no wide enough to display the data. Steps to reproduce: 1. On a 2025.Q1.4, turn on data sets FF 2. Create a dataset (I chose web contents as...

Multiple unsatisfied references when installing a hotfix in 2024.Q4.5 or 2024.Q4.6

legacy Troubleshooting

Issue After installing a hotfix in 2024.Q4.5/6, multiple unsatisfied references appear. It may appear in the start up logs or when running ds:unsatfisfied from the Gogo Shel: 2025-04-21 14:50:53.948 WARN [main][DependencyManagerSyncUtil:213] Declarative Service Unsatisfied Component...

ClassCastException during upgrade when setting maximum file size using config file

legacy Troubleshooting

Issue During the upgrade process from Liferay DXP 7.2 to 2025.Q1, a ClassCastException occurs when setting the maximum file size using the OSGi configuration file com.liferay.document.library.configuration.DLConfiguration.config. The error message indicates that a string value cannot be...

Documents and Media files are not loading after setting up a 2nd cluster node

legacy Troubleshooting

Issue Documents and Media files are not loading after setting up a 2nd cluster node. This does not affect the 1st node, and only occurs on node 2. Environment Quarterly Release DXP 7.4 DXP 7.3 Resolution Since the documents stored in the document_library are not loading at all only for...

Hindi Month Names Are Truncated in Search Results

legacy Troubleshooting

Issue After adding the JVM argument -Djava.locale.providers=CLDR, long month names in Hindi get truncated in search results. Example: "सितंबर 07, 2001" to "सितं 07, 2001" Environment Liferay DXP 2023.Q4 Resolution Set the -Djava.locale.providers property to JRE,COMPAT,CLDR in the JVM...

How to Set the Limit of Pages to Preview Documents in SaaS enviroments

legacy Troubleshooting

Issue The “Set limit of number of pages to preview” functionality is not working after configuring it on the Instance Settings level. Environment Liferay SaaS Resolution For SaaS customers, it is necessary to first request the configuration at the System level, for this it is necessary...