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...

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...

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 ...

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,...

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...

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...

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...

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...

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:...

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...

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...

Exception in thread "main" java.lang.ClassNotFoundException: com.liferay.portal.tools.DBUpgrader

legacy Troubleshooting

Issue While attempting to upgrade to the Liferay Quarterly Release, the following error was encountered, and the upgrade process failed: Exception in thread "main" java.lang.ClassNotFoundException:...

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...

I cannot scroll in content page edit mode on Tablet view

legacy Troubleshooting

Issue I have an issue with scrolling in the content page edit mode on Tablet view. I added a big image to the page. When trying to scroll on Tablet view, it does not work. Reproduction Steps: Start 2024.q3.0 Edit the...

Object Validation Not Working Post Upgrade

legacy Troubleshooting

Issue After upgrading Liferay DXP from 2024.Q3.xx to 2025.Q1.xx, Object Validation is no longer functioning as expected. Steps to reproduce: Start a clean instance of DXP 2024.Q3.12. Navigate to Control Panel >...

Unable to Trigger Object Action Notifications for Site Role Users

legacy Troubleshooting

Issue When an Object action is configured to send a notification to a site role, the notification fails to send to the users with that role. The following NoSuchRoleException is thrown in the logs: 2025-05-30...

Modal Size is Ignored for Guest Users when Using Liferay.Util.openModal()

legacy Troubleshooting

Issue When using Liferay.Util.openModal() within a fragment, the specified size (e.g., size:"xl") is visible for only logged-in users, but it is ignored for guest users. For guest users, the modal opens in a...

Entry Sequence Not Reflected in Collection Fragment Using Custom Fragment

legacy Troubleshooting

Issue When using a Collection Fragment with a Custom Fragment to display entries from a Liferay Object, the sequence of the entries is not reflected correctly on the page. The order of the entries appears to be...

Office 365 error “SyntaxError: Unexpected token '<', ..."

legacy Troubleshooting

Issue Sometimes editing a document if Office 365 fails with the error SyntaxError: Unexpected token '<', ... When that happens, the following errors are thrown in the logs ERROR...

Unable to see the site level vocabulary in collection filter

legacy Troubleshooting

Issue Unable to see the site-level vocabulary in the collection filter Steps to reproduce: 1. Start the server 2. Create the vocabulary by navigating to the 'Site Panel' > Categorisation > Categories. 3. Create...

compileOnly is not working in the build.gradle

legacy Troubleshooting

Issue We are using com.liferay.gradle.plugins.workspace version: "13.0.8" in the 2025.Q1 bundle and we noticed that when we use compileInclude in the build.gradle then only it is working. It is not working with...

B2C SSO Configuration with OpenID Connect Not Working

legacy Troubleshooting

Issue Setting up Business-to-Consumer (B2C) single sign-on (SSO) configuration with Liferay using OpenID Connect (OIDC) in Azure AD B2C is not working as expected. After enabling OpenID under Instance Settings in...

Raylife Site Creation Fails with 'Unexpected Error'

legacy Troubleshooting

Issue When creating a site using the Raylife AP or Raylife D2C templates, the process fails with the UI showing: "An unexpected error occurred." In the Liferay browser console, the "CommerceChannel is null" error...

hotfix-123 :: Currently not installed; Won't be installed: requires version 2025.Q1.XX

legacy Troubleshooting

Issue After adding a hotfix in the patching folder and running the ./patching-tool.sh info command, it shows the following response: Product information: * DXP version: 2025.Q1.x LTS * Patching Tool version:...

Search navigation not showing the correct pagination or displaying the last couple of Web Content documents

legacy Troubleshooting

Issue When using the search navigation, we've discovered that not all of the web contents are displayed. The pagination is also not reflecting the correct amount of web content documents. Steps to reproduce: 1. Start...

Connection to Analytics Cloud fails due to error unable to find valid certification path to requested target

legacy Troubleshooting

Issue Analytics Cloud is not getting configured when using an access token. The following error appears in the logs: ERROR [default task-26][ExceptionMapper:79] unable to find valid certification path to requested...

NullPointerException on assetRendererFactory after Upgrade

legacy Troubleshooting

Issue After upgrading to Liferay DXP 2025.q1, the upgrade process completes successfully. However, upon restarting the server, the following error is shown in the log: ERROR [render_portlet_jsp:122] Cannot invoke...

Liferay Marketplace App Manager Web XSS Vulnerability (CVE-2025-4388)

legacy Troubleshooting

Issue A reflected cross-site scripting (XSS) vulnerability (CVE-2025-4388) in /o/marketplace-app-manager-web/icon.jsp allows a remote non-authenticated attacker to inject JavaScript into the...

How to Optimize Language Selection for SEO

legacy Troubleshooting

Issue The language selector in Liferay DXP uses the /c/portal/update_language URL, which calls the UpdateLanguageAction.java action. This action sets the selected language and redirects the user to the...

Email Sender Configuration is not being saved

legacy Troubleshooting

Issue When modifying the Email Sender Name in our PROD environment by following these steps: Control Panel > Instance Settings > Email Access "Email Sender" in the left menu Set "XYZ" in the "Name" field > Save the...

Incorrect Pagination Behavior in the SearchResultsPortlet

legacy Troubleshooting

Issue I have an issue with the search results portlet pagination. When searching for an item by selecting a page after page 20, the first page results are shown instead of the selected page. Steps to reproduce: Set up...

Search Results