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

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

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

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

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

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

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

Search Results