Site Search - Liferay Learn

Issue We've found that our client extension disappears after Liferay is restarted. After a customElement CX is deployed, Liferay is forced to restart and our extension disappears with every restart. Environment SaaS...

Upgrade Fails with SQLIntegrityConstraintViolationException for Duplicate Repository Entry

legacy Troubleshooting

Issue When upgrading from Liferay DXP 7.2 to a newer version (7.4+ or quarterly releases), the upgrade process fails with an SQLIntegrityConstraintViolationException. The error message in the logs...

Performance Issues in Publications after Upgrading to 2024.Q1

legacy Troubleshooting

Issue Users may experience a performance drop when working with Publications. This is especially noticeable when navigating through Web Content within an active publication. Environment Liferay DXP 2024.Q1 ...

A page's Menu Display widget, Search bar widget, and Footer cannot be removed from a page's layout

legacy Troubleshooting

Issue This article documents a case where a page's Menu Display widget, Search bar widget, and Footer cannot be removed from a page's layout Environment Liferay DXP Quarterly Releases Resolution Pages inherit styles from...

Custom DDM field React error #321

legacy Troubleshooting

Issue While using our custom ddm field module we are facing react error #321 Environment Liferay DXP Quarterly Releases Resolution The issue could indicate that multiple instances of React are being loaded. Since...

Web Content Templates cache Absolute image URLs, not Relative URLs

legacy Troubleshooting

Issue The templates cache absolute image URLs instead of relative URLs. Environment 2024.Q1.12, 2024.Q1.18 Resolution Upgrade to 2024.Q2.0+ or Request a hotfix with LPD-23196, knowledgeArticleType: troubleshooting,...

Unexpected Page Redirection to an Invalid Friendly URL

legacy Troubleshooting

Issue When accessing a page with a valid friendly URL (e.g. /web/portal/manage-users), an unexpected redirection occurs to another URL (e.g. /web/portal/manage-users-a). The unintended page and its redirect...

Layout Templates Appear in the Themes Section

legacy Troubleshooting

Issue After an upgrade, custom layout templates (layouttpl) are incorrectly displayed in the "Themes" section of the page configuration. This occurs because the generated .war file for the layout...

Users removed from an LDAP server are not being removed from the Liferay user group UI when a custom service wrapper utilizes deleteUserGroupUsers(long userGroupId, long[] userIds)

legacy Troubleshooting

Issue Users removed from an LDAP server are not being removed from the Liferay user group UI when a custom service wrapper utilizes the deleteUserGroupUsers(long userGroupId, long[] userIds) method. In this case, when...

Link to Page Layout Selector shows public pages in the selector in private page configuration after saving

legacy Troubleshooting

Issue I have an issue with the Private Page of type Link to Page of this site. They create a blank site, and they add to it 2 Private Pages. One private widget page and another link to a page of this site. On the...

No theme found During Startup When a Theme is Not Yet Deployed

legacy Troubleshooting

Issue The server logs show the following messages before the theme is fully deployed: 2025-07-09 06:25:20.463 WARN [https-jsse-nio-8443-exec-14][ThemeLocalServiceImpl:220] No theme found for specified...

Personalized Experience Not Displayed when using "AND" with IP Geocoder Country

legacy Troubleshooting

Issue When creating a segmentation using the IP Geocoder Country property in combination with another condition (e.g. a user property), the personalized experience configured for this segment is not displayed for a...

Analytics option not shown at site level

legacy Troubleshooting

Issue The Analytics option is not available at site level and you cannot configure it. Environment 2024.Q4.0+ Resolution Go to Instance Configuration > Analytics Configure the name of the provider (in this case...

Error 'A folder already exists with name image.default.company.logo' during startup after Upgrade

legacy Troubleshooting

Issue After upgrading from a previous version of Liferay DXP, the server fails to start up correctly and throws a DuplicateFolderNameException in the logs. The error indicates that a folder named...

"module java.base does not 'opens java.lang.invoke'" Error Prevents Elasticsearch Sidecar Startup

legacy Troubleshooting

Issue I'm unable to get the Elasticsearch Sidecar to start after upgrading to a quarterly release of Liferay DXP. When checking the server logs, I see the following error message:...

Searching in a page created from a content page template does not work

legacy Troubleshooting

Issue I have an issue with searching in pages created from the content page template. When I search in a page and filter to "Pages", nothing happens in the page, and there are no search results. Steps to reproduce...

Password Reset Link Immediately Shows as 'No Longer Valid'

legacy Troubleshooting

Issue When a user requests a password reset, the link in the notification email leads to an error page stating, "Your password reset link is no longer valid." This occurs even if the link is clicked immediately...

How can I protect against CVE-2025-4388 vulnerability?

legacy Troubleshooting

Issue My Liferay Instance has a vulnerability to CVE-2025-4388 Environment Liferay DXP 7.2 Liferay DXP 7.3 Liferay DXP 7.4 Resolution Upgrade to 2024.Q1.13+ Request a Hotfix with LPD-46038, knowledgeArticleType:...

StaleStateException Error During Startup with OpenID Connect Configuration

legacy Troubleshooting

Issue During a Liferay DXP startup, the following error message appears in the logs, related to OpenID Connect provider configuration: ERROR [...][BatchingBatch:139] HHH000315: Exception executing batch...

Unable to add Information Templates after changing Default Language

legacy Troubleshooting

Issue When only one language is available in Instance Settings > Localization and it is not "English (United States)", the Information Templates section under Design > Templates do not load. Environment Quarterly...

Adaptive Media Processing of GIFs Leads to High Disk Usage in Temp Folder

legacy Troubleshooting

Issue When using Adaptive Media, the tomcat/temp directory grows significantly, consuming a large amount of disk space. The following error can be seen repeatedly in the logs: Unable to scale file...

Workflow Task URL for Unauthorized User Returns 404 Instead of Login Page

legacy Troubleshooting

Issue When an unauthorized user attempts to access a workflow task URL, they are shown a 404 error page instead of being redirected to the login page. This issue specifically occurs when the URL follows the...

Liferay GET Requests are blocked during new Web Content Creation

legacy Troubleshooting

Issue The Web Application Firewall blocks the Liferay GET requests, when the New Web Content Page is opened. The blocked endpoint is /o/dynamic-data-mapping-form-field-types. The GET request is blocked by having a...

HTTP 403 when accessing headless admin taxonomy API

legacy Troubleshooting

Issue 403 Forbidden error when accessing the following Headless API: GET /o/headless-admin-taxonomy/v1.0/taxonomy-vocabularies/{VocabularyID}/taxonomy-categories Environment Liferay DXP 2025.Q2 Resolution Go to the...

Admin calendar is not responding when creating an event and/or hitting the publish button

legacy Troubleshooting

Issue The admin calendar is not functioning as expected after upgrading. It isn't able to successfully create events and populates the following error on the console: Uncaught...

Site Scope is Not Available in Data Migration Tool and Other Site-Scoped Menus

legacy Troubleshooting

Issue When using the Data Migration tool to import entries into a site-scoped Object, the "Scope" dropdown only displays the "Global" option. A similar behavior is observed in other areas, such as when editing a...

OAuth2 Token sometimes gets 401 response

legacy Troubleshooting

Issue Sometimes users are unable to log in because their OAuth2 tokens receive a 401 "Unauthorized" response. This seems to happen randomly, and the tokens should be valid. Environment Liferay DXP Resolution...

Email Notification fails to deliver when recipient type is set to the Owner role

legacy Troubleshooting

Issue A trigger on a custom object is configured to send an email, but it fails to deliver it when the recipient type is set to Owner. Environment Liferay DXP 2025.Q1 Resolution This is an known issue on this...

Last Login Date is not updated in the User's and Organizations Menu

legacy Troubleshooting

Issue The Last Login Date displayed in the Users and Organizations UI is not updating accurately. Even after a user logs in, the date remains unchanged. Environment Liferay DXP 2024.Q4+ Resolution Enable Feature...

Session Timeout Setting Does Not Take Effect

legacy Troubleshooting

Issue After configuring the session timeout in the portal-ext.properties and web.xml files, the session still expires sooner than the configured value. For example, the session expires after 15 minutes, even...

Datasets Are Not Displayed After Upgrading to DXP 2025.Q2

legacy Troubleshooting

Issue After upgrading to DXP 2025.Q2, existing Datasets are not displayed on pages. The Dataset fragment may appear collapsed when editing the page but is not rendered for users. Newly created Datasets are displayed...

Node in Cluster Fails to Start with Deadlock and Circular Reference Errors

legacy Troubleshooting

Issue When starting a Liferay DXP cluster, the node fails to start and gets stuck. The thread dump show a combination of errors, including deadlocks, circular references, and class not found...

Multi-Factor Authentication (MFA) email is not being sent for logins

legacy Troubleshooting

Issue Multi-Factor Authentication (MFA) email is not being sent for logins, and due to this, users are not able to login successfully. Environment Quarterly Release Resolution One potential cause for this is a mail server...

In the Documents and Media portlet, the search is not performed on the selected folder in its configuration

legacy Troubleshooting

Issue I have an issue with the documents and media portlet document search. I have two document folders and two document and media portlets on a page. One folder is set at a document folder, the other is set at another...

Upgrade to a Quarterly Release Fails with "Elasticsearch sidecar could not be started" Error

legacy Troubleshooting

Issue When upgrading from Liferay DXP 7.2 to a Liferay DXP 7.4 Quarterly Release, the server startup fails. The logs show errors related to Elasticsearch, such as: 2025-07-10 09:29:51.414 ERROR...

Inconsistent Roles in Assign/Unassign Dialogs After Upgrade

legacy Troubleshooting

Issue After upgrading from Liferay DXP 7.2 to 2025.Q1, there are inconsistencies in the Site Roles displayed for users. While the main members list shows the correct roles for a user, the "Assign Roles" and...

Empty searches return no results using a Text Match Over Multiple Fields blueprint element

legacy Troubleshooting

Issue When a Blueprint is configured with the Text Match Over Multiple Fields element, performing an empty search yields no results. Environment Liferay DXP 7.4 U5+ Liferay DXP Quarterly Releases Resolution Text...

Field Group Fields Missing in "Untranslated" View for Non-Default Locale

legacy Troubleshooting

Issue When we check untranslated field group fields in our web content for the non-default locale, they are not visible. Environment Liferay DXP Quarterly Releases Resolution Contact Support and request a hotfix with...

Asset Publisher Back Button Redirects to a Blank Page Instead of the Previous Page

legacy Troubleshooting

Issue When using an Asset Publisher to display a list of assets, clicking on an asset correctly navigates to a detail page. However, when clicking the 'back' arrow provided by the Asset Publisher on the...

Headless Batch Import: Attachment Field with URL Creates Duplicate Empty File

legacy Troubleshooting

Issue When using the Headless Batch Engine to import Object Entries with an attachment field using a file URL, following the documentation here, we see that it creates duplicate empty files. Environment Liferay DXP...

Search Results