Site Search - Liferay Learn

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

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

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

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

Hot Backups of the Liferay Database: Risks and Recommendations

legacy

Issue Is it safe to perform a hot backup of the Liferay database while the server is still running? What are the risks involved, especially concerning data consistency? Environment Liferay DXP...

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

JavaScript code in Link to URL page gets executed

legacy How To

Issue When creating a new public page of type "Link to URL" and using JavaScript code as the URL, the code gets executed when accessing the page. Environment Liferay DXP 2025.Q1 and prior Quarterly Releases Resolution...

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

Application Accept Special Characters in Input Fields

legacy

Issue The application accepts special characters in input fields. Ex: " ' ` * ; % _ = & | \ ? ~ < > ^ () [] {} $ \n\ Steps to Reproduce: 1. Start Liferay server. 2. Navigate to the user’s profile. 3. Click on...

After Upgrading to 2024.Q1 User Public Pages Return 404 Error if Accessed via PlId

legacy How To

Issue After upgrading from Liferay DXP 7.4 u48 to 2024.Q1, user public pages with guest permissions return a 404 error, except for the page owner. The portal administrator also cannot access these pages. Environment...

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

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

"Information Templates" page is blank

legacy Troubleshooting

Issue We've observed an undesirable behavior when trying to access "Information Templates". When navigating to Design > Templates > Information Templates, the page is blank. There is no option to create a new...

Changes Not Reflecting Across Nodes

legacy Troubleshooting

Issue In a clustered Liferay environment, changes made on Node 1 are not consistently reflected on Node 2. The changes only appear after restarting the Liferay server. Environment Liferay DXP [All versions]...

Step-by-Step SAML Integration with Liferay and Keycloak

legacy How To

Issue Is Keycloak supported with Liferay? If yes, how can SAML be configured with Liferay? Environment Lifeary DXP [All versions] Resolution As per Liferay’s official compatibility matrix, Keycloak is not listed as a...

Error Creating Web Content with Nested Fields via Headless API: 'Value Should Not Be Set for Transient Field'

legacy Troubleshooting

Issue When attempting to create web content that includes nested fields using the Headless API, the user encounters a 400 Bad Request error. The response message states: "Value should not be set for transient field...

Company-scoped objects' workflow tasks do not get assigned to users with only site-scoped roles

legacy Troubleshooting

Issue Given: A company-scoped custom object A workflow assigned to the above-mentioned object (at Global Menu > Applications tab > Workflow section > Process Builder > Assignments tab) And a workflow task...

Dynamic Data Lists Changes Not Managed Within Publications in 7.3

legacy

Issue Dynamic Data Lists (DDLs) changes are not managed within Publications mode. Any changes or new DDL records are directly published to production. Environment DXP 7.3 Resolution DDL changes are not supported...

Web Content Structures Not Visible in Second Instance After Upgrade

legacy Troubleshooting

Issue After upgrading to a Quarterly Release, web content structures are not visible in the second instance when creating web content. Environment Liferay Quarterly Release upgraded from a previous version...

How to Enable Audio for CAPTCHA

legacy How To

Issue How can users enable audio for CAPTCHA verification? Environment Liferay DXP 7.4 and above Resolution Liferay does not provide out-of-the-box (OOTB) support for audio CAPTCHA functionality. However, users...

Proxy paths are not honored after upgrading to 2025.Q1.9

legacy Troubleshooting

Issue After upgrading to 2025.Q1.9 we've found that our page are largely inoperable. There are a large amount of console errors related to missing functions, missing MIME types, missing AUI, etc. Environment...

Pages Appear in Search Results But Lead to 404 Errors

legacy Troubleshooting

Issue Some search results lead to 404 pages, even after reindexing. Pages exist but cannot be navigated to with the search bar. Search bar is unresponsive when clicking on certain results. Environment...

How to Grant Add User Permission to a New Role?

legacy Troubleshooting

Issue We set up a new role and want to enable it to add new users to the portal. When we navigate to Define permissions > Users and Organizations, there is no "Add User" permission. Even is granting all permissions...

Liferay service restarts frequently

legacy Troubleshooting

Issue Since we allowed access to some users to contribute content, we are getting many issues with Liferay service restarts. While we are working with the platform, following error message is shown without any...

NoClassDefFoundError: org/apache/commons/compress/archivers/zip/ZipArchiveInputStream

legacy Troubleshooting

Issue We are putting up commons-io on osgi/module folder so it will be readily available to all modules, on our previous version of Liferay (DXP 2024 Q1.7), the commons-io worked, however now we are updating to the latest...

Analytics Cloud Stuck On "Redirecting to your identity provider..."

legacy Troubleshooting

Issue When attempting to access Analytics Cloud via https://analytics.liferay.com the site hangs indefinitely on the "Redirecting to your identity provider..." message. This can occur despite successfully logging...

User Workflows Not Appearing Under 'Assigned to My Roles'

legacy Troubleshooting

Issue We have enabled a workflow for approving new user account creation. While the Admin user gets the notficiation about the workflow task, if they navigate to My Workflow Tasks > Assigned to my Roles, the task is...

Loss of Client Extension Configurations After Publishing with Local Staging

legacy Troubleshooting

Issue After configuring settings such as JS or CSS on the pages of a site with Local Staging enabled, the changes are being lost after publishing to Live Environment 2024.Q1.12 (or older versions) Resolution This...

Is it possible to block direct access to a portlet render URL?

legacy

Issue We would like prevent direct access to portlet render URLs (/c/portal/render_portlet) that bypass normal navigation within the portal. These portlets have been manually added to the page. Example URL:...

OHS IP Appended to Image URLs on One Application Server Node

legacy Troubleshooting

Issue Inconsistent behavior is observed between two application server nodes with identical configurations. One node appends the OHS (Oracle HTTP Server) IP address to image URLs, causing 404 errors, while...

Path error for mariadb.jar

legacy

Issue Booting Liferay DXP 2025.Q1 we see in log file following error: May 22 11:37:49.551 build-3994 liferay[liferay-7c588c8bd4-mg686] [dxp] ERROR [main][StartupAction:68] Files...

Permissions error when restoring backup

legacy Troubleshooting

Issue We are trying to restore a PRO environment backup into DEV environment. And we see in the log several errors related to Document Library when decompressing: May 05 16:13:15.812 build-3964...

Is it possible to integrate a Liferay site content with external platforms like SharePoint?

legacy

Issue Is it possible to integrate a Liferay site content with external platforms like SharePoint, beyond .LAR file exports? Environment Liferay 7.4+ Resolution Liferay sites are exported and shared as .LAR files. These...