Site Search - Liferay Learn

Deploying and Managing SAML on Liferay DXP

This troubleshooting guide is meant to supplement the existing SAML documentation. The information in this guide explains in more detail to demonstrate the most common use cases. ...

ユーザーグループにユーザーをアサイン後、そのユーザーのSSOログイン直前にアサインを外される

legacy Troubleshooting

, knowledgeArticleType: troubleshooting, legacy: true, name: ユーザーグループにユーザーをアサイン後、そのユーザーのSSOログイン直前にアサインを外される, showDisclaimerMessage: true, sourceTeam: Support, ticketNumber: 128674, title:...

お知らせと警告で、表示日を将来の日付に設定すると、リストに表示されません。

legacy Troubleshooting

, knowledgeArticleType: troubleshooting, legacy: true, name: お知らせと警告で、表示日を将来の日付に設定すると、リストに表示されません。, showDisclaimerMessage: true, sourceTeam: Support, ticketNumber: 112254, title: お知らせと警告で、表示日を将来の日付に設定すると、リストに表示されません。

Liferay PaaSでのSAML証明書作成方法

legacy Troubleshooting

, knowledgeArticleType: troubleshooting, legacy: true, name: Liferay PaaSでのSAML証明書作成方法, showDisclaimerMessage: true, sourceTeam: Support, ticketNumber: 106395, title: Liferay PaaSでのSAML証明書作成方法

Dynatraceインスタンスとの接続が切断できません。

legacy Troubleshooting

, knowledgeArticleType: troubleshooting, legacy: true, name: Dynatraceインスタンスとの接続が切断できません。, showDisclaimerMessage: true, sourceTeam: Support, ticketNumber: 110658, title: Dynatraceインスタンスとの接続が切断できません。

ページコメントで画像の添付をしたいです。

legacy Troubleshooting

, knowledgeArticleType: troubleshooting, legacy: true, name: ページコメントで画像の添付をしたいです。, showDisclaimerMessage: true, sourceTeam: Support, ticketNumber: 107730, title: ページコメントで画像の添付をしたいです。

Webコンテンツ作成時に、お知らせの内容を確認しようとすると権限エラーが表示されます。

legacy Troubleshooting

, knowledgeArticleType: troubleshooting, legacy: true, name: Webコンテンツ作成時に、お知らせの内容を確認しようとすると権限エラーが表示されます。, showDisclaimerMessage: true, sourceTeam: Support, ticketNumber: 107540, title:...

表示言語の設定

legacy Troubleshooting

, knowledgeArticleType: troubleshooting, legacy: true, name: 表示言語の設定, showDisclaimerMessage: true, sourceTeam: Support, ticketNumber: , title: 表示言語の設定

Piwikのトラッキングコードが期待通りに動作しない場合の対応

legacy Troubleshooting

, knowledgeArticleType: troubleshooting, legacy: true, name: Piwikのトラッキングコードが期待通りに動作しない場合の対応, showDisclaimerMessage: true, sourceTeam: Support, ticketNumber: , title:...

開発者（キャッシュ無効化）モードを使用する方法

legacy Troubleshooting

, knowledgeArticleType: troubleshooting, legacy: true, name: 開発者（キャッシュ無効化）モードを使用する方法, showDisclaimerMessage: true, sourceTeam: Support, ticketNumber: , title: 開発者（キャッシュ無効化）モードを使用する方法

「Redirect URL ... not allowed」という警告メッセージが出力される

legacy Troubleshooting

, knowledgeArticleType: troubleshooting, legacy: true, name: 「Redirect URL ... not allowed」という警告メッセージが出力される, showDisclaimerMessage: true, sourceTeam: Support, ticketNumber: , title:...

スクリーン名について(Liferay 6.2版)

legacy Troubleshooting

, knowledgeArticleType: troubleshooting, legacy: true, name: スクリーン名について(Liferay 6.2版), showDisclaimerMessage: true, sourceTeam: Support, ticketNumber: , title: スクリーン名について(Liferay 6.2版)

Liferay DXP Agent Fails to Start on Jakarta (Tomcat 10) Images with javax.annotation Error

Troubleshooting

Issue When using a Liferay DXP instance deployed on a Jakarta-based image (e.g., Tomcat 10), the liferay-dxp-agent bundle may fail to start. The logs will show an org.osgi.framework.BundleException error related to an unresolved package import. A key part of the error message will look...

How does Let's Encrypt validate custom domains to create their certificate?

legacy Troubleshooting

Issue How does Let's Encrypt validate custom domains to create their certificate? Environment Liferay Cloud Resolution Custom domains undergo a challenge before certificates can be properly issued. If the challenge...

How do you edit robots.txt for virtual host public pages?

legacy Troubleshooting

Issue We are trying to edit the robots.txt file through public pages, but we are getting the following message: 'Please set the virtual host before you set the robots.txt'. We are using one instance with two sites and...

Rating does not work on the Asset Publisher

legacy Troubleshooting

Issue I have an issue with the Asset Rating. I create web content or any asset that can be rated. I place an Asset Publisher on a page to display the content. I enable the ratings on the Asset Publisher. When I rate...

Liferay Server Fails to Start Due to OutOfMemoryError: unable to create new native thread

legacy Troubleshooting

Issue The Liferay DXP server fails to start. The log files contain the following error message: ERROR [...][...] failure submitting task to thread pool java.lang.OutOfMemoryError: unable to create new native thread...

Account Roles Are Not Visible After a LAR File Import

legacy Troubleshooting

Issue After exporting roles via a LAR file and importing them into a new environment, Account Roles are not visible under the Account Roles tab in Control Panel > Users > Roles Regular Roles and Site Roles from the...

Field groups in Web Content Structures become Field Sets after Import or Modification

legacy Troubleshooting

Issue When a web content structure containing a field group is imported via a LAR or JSON file, the field group is converted into an uneditable, referenced field set. This issue also occurs when...

Fieldsets with Custom Names Disappear When Filtering by Translation Status

legacy Troubleshooting

Issue In the web content editor, fieldsets that do not follow the default naming pattern (e.g., Fieldset1234) are hidden when filtering by "Untranslated" fields. This issue is caused by a regex that incorrectly assumes...

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

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

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

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

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

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

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

Link to Page Layout Selector shows public pages in the selector in private page configuration after saving

legacy Troubleshooting

Issue I have an issue with the Private Page of type Link to Page of this site. They create a blank site, and they add to it 2 Private Pages. One private widget page and another link to a page of this site. On the...

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

No theme found During Startup When a Theme is Not Yet Deployed

legacy Troubleshooting

Issue The server logs show the following messages before the theme is fully deployed: 2025-07-09 06:25:20.463 WARN [https-jsse-nio-8443-exec-14][ThemeLocalServiceImpl:220] No theme found for specified...

Personalized Experience Not Displayed when using "AND" with IP Geocoder Country

legacy Troubleshooting

Issue When creating a segmentation using the IP Geocoder Country property in combination with another condition (e.g. a user property), the personalized experience configured for this segment is not displayed for a...

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

Error 'A folder already exists with name image.default.company.logo' during startup after Upgrade

legacy Troubleshooting

Issue After upgrading from a previous version of Liferay DXP, the server fails to start up correctly and throws a DuplicateFolderNameException in the logs. The error indicates that a folder named...

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

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

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

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

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

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

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

Search Results