Site Search - Liferay Learn

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

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

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

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

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

Email Notification fails to deliver when recipient type is set to the Owner role

legacy Troubleshooting

Issue A trigger on a custom object is configured to send an email, but it fails to deliver it when the recipient type is set to Owner. Environment Liferay DXP 2025.Q1 Resolution This is an known issue on this...

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Updating Web Content's Custom Integer Field Using Headless API

legacy Troubleshooting

Issue When trying to update the web content's custom field value of type Integer with API, an errorClassCastException occurs. Steps to reproduce: Create a custom field of integer in the web content article. Create...

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

Changing locale using the Language selector in a private page redirects to a 404 error page

legacy Troubleshooting

Issue I have an issue with the use of the language selector in a private page. When I try to change the locale using the language selector, I get redirected to a 404 error page. Reproduction Steps: Start 2024.q1.17....

Builds being deployed to the Liferay Cloud console fail with the following error: Unknown arguments: use-external-git, useExternalGit

legacy Troubleshooting

Issue Any builds being deployed to the Liferay Cloud console fail with the error: Unknown arguments: use-external-git, useExternalGit Environment PaaS Quarterly Release Resolution There is an incompatibility with CLI...

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

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

Page Audit is not displaying errors properly

legacy Troubleshooting

Issue I have an issue with Page Audit. The feature has stopped working. When initiating an audit on a page, the progress bar reaches 99% and then stops, resulting in a null pointer exception error being thrown in the...

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

Unable to edit or create Collections

legacy Troubleshooting

Issue We've discovered a behavior that occurs when trying to edit existing collections or creating new collections. The page fails to load. The main error that popualates references a missing classname:...

I cannot schedule web content using a date in the past

legacy Troubleshooting

Issue I have an issue with the web content scheduling. I set the time zone of the user's OS to CET while the user and the server are set to UTC (by default). I create web content and schedule it to be less than 1 hour...

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