Site Search - Liferay Learn

Unable to Trigger Object Action Notifications for Site Role Users

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

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

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

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

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

Liferay GET Requests are blocked during new Web Content Creation

legacy Troubleshooting

Issue The Web Application Firewall blocks the Liferay GET requests, when the New Web Content Page is opened. The blocked endpoint is /o/dynamic-data-mapping-form-field-types. The GET request is blocked by having a...

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

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

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

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

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

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

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

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

OAuth2 Token sometimes gets 401 response

legacy Troubleshooting

Issue Sometimes users are unable to log in because their OAuth2 tokens receive a 401 "Unauthorized" response. This seems to happen randomly, and the tokens should be valid. Environment Liferay DXP Resolution...

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

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

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

Password Reset Link Immediately Shows as 'No Longer Valid'

legacy Troubleshooting

Issue When a user requests a password reset, the link in the notification email leads to an error page stating, "Your password reset link is no longer valid." This occurs even if the link is clicked immediately...

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

Site Scope is Not Available in Data Migration Tool and Other Site-Scoped Menus

legacy Troubleshooting

Issue When using the Data Migration tool to import entries into a site-scoped Object, the "Scope" dropdown only displays the "Global" option. A similar behavior is observed in other areas, such as when editing a...

HTTP 403 when accessing headless admin taxonomy API

legacy Troubleshooting

Issue 403 Forbidden error when accessing the following Headless API: GET /o/headless-admin-taxonomy/v1.0/taxonomy-vocabularies/{VocabularyID}/taxonomy-categories Environment Liferay DXP 2025.Q2 Resolution Go to the...

Admin calendar is not responding when creating an event and/or hitting the publish button

legacy Troubleshooting

Issue The admin calendar is not functioning as expected after upgrading. It isn't able to successfully create events and populates the following error on the console: Uncaught...

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

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

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

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

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

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

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

Client Extension disappears

legacy Troubleshooting

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

StaleStateException Error During Startup with OpenID Connect Configuration

legacy Troubleshooting

Issue During a Liferay DXP startup, the following error message appears in the logs, related to OpenID Connect provider configuration: ERROR [...][BatchingBatch:139] HHH000315: Exception executing batch...

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

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

Datasets Are Not Displayed After Upgrading to DXP 2025.Q2

legacy Troubleshooting

Issue After upgrading to DXP 2025.Q2, existing Datasets are not displayed on pages. The Dataset fragment may appear collapsed when editing the page but is not rendered for users. Newly created Datasets are displayed...

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

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

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

Can we retrieve the list of Collections/ContentSets' names using headless API?

legacy Troubleshooting

Issue Using Liferay's headless-delivery API, it’s not possible to retrieve Collections' (referred as ContentSets in the API) names. The user wants to retrieve the collection by its name. There is a similar feature for...

HotDeployException thrown at startup sometimes for some of our custom portlets

legacy Troubleshooting

Issue we have a problem with our portlets. Sometimes when we restart Liferay, some portlets are failing to deploy. We do not have exact scenario. It can happen for any of our portlet during restart. Here is exception that...

Unable to start Liferay Portal with error: Current URL / generates exception: java.lang.NullPointerException

legacy Troubleshooting

Issue I am unable to start my Liferay Portal. The following errors are present in the log. 2024-11-19 05:16:09.815 ERROR [main][BundleStartStopLogger:62] file:/opt/liferay/osgi/modules/activation.jar has a null...

com.liferay.expando.kernel.model.ExpandoBridge cannot be found after upgrading to Quarterly Release

legacy Troubleshooting

Issue After upgrading to Liferay Quarterly Release 2024.Q1.1, the portal logs are displaying an error related to Commerce: ERROR [SystemExecutorServiceUtil-1][ROOT:47] bundle...

In Liferay DXP 2023.q4.4, clustered environment fails to load additional nodes

legacy Troubleshooting

Issue When using Liferay DXP 2023.q4.4 deployed in an environment, the initial node loads up without any issues, but any additional nodes result with the following traces: In JBoss EAP 7.4 Update 17: 2024-10-05...

Filtering objects by their NestedFields.

legacy Troubleshooting

Issue Having a relationship between two objects A and B. It is possible to make queries to the /o/c/as api filtering by a field of object B as nestedField. curl -X 'GET' \...

Receiving the 'Unable to parse upload request' when try to upload folder

legacy Troubleshooting

Issue Receiving the error in the logs when trying to upload the folder using the custom module. Steps to reproduce: 1. Start the server. 2. Deploy the sample portlet for uploading the folder in the bundle. 3....

Getting dozens of "BundleException: A bundle is already installed with the name XXX" errors on sever startup

legacy Troubleshooting

Issue When starting the server, multiple messages similar to the following are logged, indicating failed module installations (typically after an upgrade): 2024-11-19 10:05:39.082 ERROR...

Upgrade Failed due to the Error "No User exists with the primary key..."

legacy Troubleshooting

Issue When doing the database upgrade from 7.2 DXP-20 to Liferay DXP 7.4 QR 2024.Q3.0, the upgrade can fail with the following error: ERROR [main][UpgradeExecutor:333] Failed upgrade process for module...

Error: Unable to copy from file:/opt/liferay/osgi/modules/biz.aQute.remote.agent-6.4.0.jar

legacy Troubleshooting

Issue When starting the server, the following exception is printed in the logs: 2024-09-25 17:50:18.363 ERROR [main][ModuleReadHookImpl:88] Unable to copy from...

Is Liferay vulnerable to CVE-2024-7254?

legacy Troubleshooting

Issue I would like to know if Liferay is vulnerable to CVE-2024-7254. Is Liferay affected by CVE-2024-7254? This article outlines the concerns of CVE-2024-7254 vulnerability with respect to the Liferay DXP. Environment...

Unable to see the 'SEO' icon in Quarterly Release 2024.Q2

legacy Troubleshooting

Issue According to Configuring XML Sitemaps documentation, users are unable to locate the 'SEO' icon in 2024.Q2 Environment Quarterly Release 2024.Q2 Resolution In order to see the 'SEO' icon, users need to...

jgroups WARN in the Logs When Starting the Second Node in a Two Node Cluster

legacy Troubleshooting

Issue During restart of a node in a clustered environment, WARN logs are thrown due to jgroup jgroups receive failures are logged as warnings during cluster node startup WARN...

Log Directory for Liferay

legacy Troubleshooting

Issue The log folder may become oversized, causing server hang-ups, so how do I configure the logging directory for Liferay? Environment Liferay DXP 7.3 Liferay DXP 7.4 Resolution The following are the steps...

Error message: Portal property "session.timeout.auto.extend" was modularized to com.liferay.frontend.js.web as "auto-extend"

legacy Troubleshooting

Issue When starting up Liferay DXP, the following error message is displayed in logs: ERROR [main][VerifyProperties:138] Portal property "session.timeout.auto.extend" was modularized to com.liferay.frontend.js.web as...

Certificate details of internal load balancer

legacy Troubleshooting

Issue There are few static IPs for private S2S connectivity, over different services like webserver and database. However, for webserver whose static IP is 172.xx.xx.xx, the certificate is updated at the...

Spring Boot Client Extension fails with [invalid_token_response] An error occurred while attempting to retrieve the OAuth 2.0

legacy Troubleshooting

Issue We have a Spring Boot extension client that interacts with the Liferay APIs and that makes the OAuth2 challenge via OAuth2AccessToken oAuth2AccessToken =...

Security scan detected a "Reference to Windows file path is present in HTML"

legacy Troubleshooting

Issue Our security scan detected a "Reference to Windows file path is present in HTML" in the following URL:...

Error message: Portal property "cluster.executor.debug.enabled" was renamed to "cluster.link.debug.enabled"

legacy Troubleshooting

Issue When starting up Liferay DXP, the following error message is displayed in logs: ERROR [main][VerifyProperties:220] Portal property "cluster.executor.debug.enabled" was renamed to "cluster.link.debug.enabled"...

Unable to initialize bundle

legacy Troubleshooting

Issue Tomcat folder is missing after running blade gw initbundle command. Steps to reproduce: 1. blade init -v dxp-7.4-u102 liferay-workspace 2. echo >> liferay-workspace/gradle.properties 3. echo...

Search Results