Site Search - Liferay Learn

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

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

Creating an assetlink and .well-known in PaaS Environment

legacy How To

Issue How can I add an assetlink and .well-known configuration within my PaaS Environment? Environment Liferay PaaS Resolution As a PaaS customer, you have the necessary permissions to add files and directories...

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

Client extensions for different business needs

legacy How To

Issue How we can leverage client extensions? Environment Liferay DXP Quarterly releases Resolution As of 2024.Q4 Liferay CLI tool and Liferay Themes Toolkit are deprecated. Instead, a new approach is available....

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

How to handle Google Fonts locally

legacy How To

Issue For private environments with no access to the internet, we need to handle fonts locally. Environment Liferay DXP Quarterly releases Resolution The recommended way to handle custom fonts (especially in private,...

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

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

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

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

Time-Based Authenticator QR Code Not Populating

legacy Troubleshooting

Issue When trying to set up the QR Code for MFA settings, following this documentation Multi-Factor Authentication Checkers, we've found that the QR code doesn't populate. It should be populating under "Shared...

Sharepoint configuration

legacy Troubleshooting

Issue While configuring Sharepoint integration following this documentation, we are facing the following HTTP 500 internal server error, and found that we have multiple versions of the connector installed....

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

Environment variable for elastic password

legacy How To

Issue For security reason, we need to handle the Elastic password via an environment variable, using OSGI .config files. Checking the documentation, it seems to not be possible on 7.0...

Subtype missing after importing information template

legacy

Issue When an information template is exported from one environment and imported into another, the link to the web content structure's subtype is lost. The template remains linked to the main structure (e.g., Web...

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

Not able to see icons in a Spritemap Client Extension

legacy Troubleshooting

Issue After upgrading to 2025.Q1.8, the icons from the Spritemap CX (Client Extension) are missing and requests for the Spritemap have been blocked Environment Liferay DXP Quarterly Release 2025.Q1.8 Resolution In...

Users with permissions to create Collections are unable to select global Document Types

legacy Troubleshooting

Issue Users with permissions to create Collections are unable to select global Document Types when creating a new Manual or Dynamic Collection with the Document subtype. Environment Quarterly Release Resolution Please...

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

CVE-2025-27867

legacy

Issue We would like to verify if our Liferay instance is vulnerable to CVE-2025-27867. Environment DXP 7.3 Resolution Liferay does not use the Apache Felix Web Console out-of-the-box, and on its own, should not be...

Why is there a large difference in CPU usage within a clustered environment?

legacy

Issue When viewing Application Metrics, there is a large difference in CPU usage within a clustered environment. For example, CPU usage is showing 5% on one node while it is 50% on another node. Environment Liferay PaaS...

When I click the "Previous" button on checkout, the saved shipping address is not populated

legacy Troubleshooting

Issue I have an issue with the commerce order. I added a product to the cart. I went to the order page where I provided the shipping address, then clicked "Next. On the checkout page, when they click "Previous", the...

How Blueprints Work in Liferay while using Fuzziness?

legacy

Issue How Blueprints Work in Liferay while using Fuzziness? Environment Liferay Quarterly Release Resolution Example case: 1.) Create new environment. 2.) Create new blueprint 3.) Open preview 4.) Add Text...

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

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

Search Results