Site Search - Liferay Learn

Issue We have multiple SSL certificates and want to use them in virtual instances that run under a different domain from the main instance. Environment DXP 2024.Q3 Resolution If behind a reverse proxy, configure...

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

Why is the Product Specification Key Different from the One Defined in the Specification List?

legacy

Issue When creating a product specification, a key is defined under Product Management > Specifications. However, after adding this specification to a product, the Product Specification widget on the product page...

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

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

"fields" and "nestedFields" Parameter Not Applied to Account System Objects

legacy

Issue Using the GET Rest API for account-restricted objects does not seem to follow the `fields` and `nestedFields` parameters for the linked account. For example, when querying a custom object and attempting to...

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

Despite the fix "Relay state exceeds 80 bytes" error and redirections to IDP

legacy Troubleshooting

Issue Despite the fix "Relay state exceeds 80 bytes" error and redirections to IDP We found this article and had a hotfix with LPS-76246 We found that the fix is not applied correctly. Environment Liferay DXP 7.3...

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

Paginator Elements Are Not Translated to the Site's Language

legacy How To

Issue When using a paginator component on a site, the links to the different pages (e.g., "Page 1", "Page 2") are displayed in English. These labels do not get translated even when the site's language is...

"reserved-article-url-title" does not return the localized URL Title in Freemarker templates

legacy

Issue When using the .vars['reserved-article-url-title'].data variable in a Freemarker template, it only provides the URL title for the default language. Environment Liferay DXP 2024.Q1+ Resolution This is the...

How to Add a Custom Element as a Control Panel or Site Administration Widget

legacy How To

Issue Is it possible to add a Custom Element, created via a Client Extension, as a widget in the Control Panel or Site Administration menu? Environment Liferay DXP 2025.Q1 Resolution Yes, it is possible to add custom...

Can Liferay Support add a new user to the SaaS environment?

legacy

Issue Is the Liferay Support team able to add a new user to the SaaS environment (i.e., the Liferay DXP environment)? Environment Liferay SaaS Resolution A new user will either need to be created on the site of your...

Google Cloud Translation Fails with "Too many segments" Error

legacy Troubleshooting

Issue When attempting to use the automatic translation feature for an entire page o contents with multiple fields, the process fails. The logs show the following error:...

Is Oracle 23ai Supported by Liferay DXP?

legacy

Issue Is Oracle database version 23ai compatible with Liferay DXP? Environment Liferay DXP 7.4 Liferay DXP Quarterly Releases Resolution Currently, Liferay DXP does not support Oracle version 23ai. The...

Node.js Version for Client Extension Development and Handling Security Vulnerabilities

legacy

Issue When developing client extensions with React for Liferay DXP 2024.Q4 or newer, what is the recommended Node.js version? The official compatibility matrix suggests Node.js version 20.12.2, but this version...

NullPointerException in getArticleDisplay without a ThemeDisplay

legacy Troubleshooting

Issue After upgrading to Liferay DXP 7.4 2025.Q1.0 or a newer version, calling the JournalArticleLocalService.getArticleDisplay() method for a Journal Article located in the Global Site fails if the...

Since property 'live.users.enabled' is deprecated, is there a replacement for managing session concurrency?

legacy

Issue The property live.users.enabled is required to manage simultaneous user logins via the auth.simultaneous.logins property. However, live.users.enabled has been marked as deprecated for a while. This raises...

Logging to application always taking to home page instead of request url

legacy Troubleshooting

Issue We are encountering an issue where users are consistently redirected to the application's homepage immediately following SAML authentication, even when an alternative page was initially requested. Environment...

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

Unable to schedule Web Content with past dates

legacy Troubleshooting

Issue As of 2025.Q1, you can no longer edit the "Display Date" field or schedule the publication date for past dates—only for future ones. As a result, you are unable to perform a key use case that used to...

Cluster won't be established and traces show Autodetecting JGroups outgoing IP address and interface for false:80

legacy Troubleshooting

Issue After setting up a Liferay cluster, the cluster won't be properly established. There's a suspicious trace in the logs INFO [SCR Component Actor][JGroupsClusterChannelFactory:130] Autodetecting JGroups...

Is Liferay affected by CVE-2024-6783?

legacy

Issue After performing a security scan, a Vue.js vulnerability reported as CVE-2024-6783 is identified. Environment Liferay DXP 7.4 - Quarterly Releases Resolution Liferay is not impacted by CVE-2024-6783 as Liferay DXP...

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

Deploys failing due to "requested flag is either misspelled or unsupported by this database type"

legacy Troubleshooting

Issue New deploys fails due to the database service and backup restores too Checking the database service logs you identify the following: INFO May 15 14:54:39.664 1904 database 75b864bd48-zzc6n [INFO] Instance...

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

Error in Jenkins builds

legacy Troubleshooting

Issue When we generate a new build, we get the following error: ERROR: the command "[lcp, deploy, --only-build, --project, resumed, --metadata,...

Web Content is being approved after the expiry date

legacy

Issue When users enable workflow for web content, the expiration date feature is not working as expected. Steps to reproduce: 1. Start the server 2. Apply 'Single Approver Workflow' for web content. 3. Navigate to...

How to expose large object entries to guest users without manually assigning the permissions

legacy How To

Issue How to expose object entries to guest users without manually assigning permissions to each entry. Assigning permission will work here but if the number of entries in the object is large, it will not be...

The drop-down is not working when clicking anywhere apart from the arrow

legacy Troubleshooting

Issue The category filter fragment only expands or collapses the category list when clicking the dropdown arrow. Clicking the category name itself does not trigger this action. Steps to reproduce: 1. Navigate to...

CVE-2021-29044

legacy How To

Issue We would like to verify if our Liferay instance is vulnerable to CVE-2021-29044 Environment DXP 7.2, DXP 7.3 Resolution Please see if your current patch level is higher than 7.2 FP10, or 7.3 DXP1. If your current...