Site Search - Liferay Learn

DXPで「ldap.import.create.role.per.group」を使用する方法

DXPでldap.import.create.role.per.groupを使用する方法 Liferay 6.2には、LDAPのグループをインポートした際に同名のロールを自動的に作成するためのプロパティldap.import.create.role.per.groupがあります。DXPではportal-ext.propertiesでの設定はできなくなり、代わりにGUIから設定する必要があります。 GUIからの設定方法は以下の2つがあります。解決策インスタンス毎に設定する方法「コントロールパネル＞設定＞インスタンス設定」へ移動「認証」パネルの「LDAP」をクリック...

DXPのAuditログをファイルへ出力する方法

legacy How To

DXPのAuditログをファイルへ出力する方法詳細留意点この設定はDXP 7.0 Fix Pack 12以上で有効です要件例 Auditログを、データベーステーブルではなくログファイルとして出力する一日おきにログローテーションする設定手順「コントロールパネル＞設定＞システム設定＞基本設定＞Logging Message Audit Message Processor」へ移動「Enabled」にチェックを入れ、任意の「Log message format（CSV / JSON）」を選択し、更新アプリケーションサーバーを停止...

Liferay DXPのインストール

legacy How To

インストールのため必要な準備が整った際、Liferay DXPのインストールを開始できます。インストールを完了させるにはバンドルが最も簡単な方法なので、下記のインストール手順はすべて、バンドルがインストールされていることを想定しています。 Liferay Home Liferay DXPバンドルには、アプリケーションサーバーとは関係なく、同一のフォルダ構造が含まれています。最上位のフォルダは、Liferay DXPのリリースに対して名前が付けられます。このフォルダの名称は Liferay Home...

Help Centerチケット添付用のパッチレベルファイルを取得する

legacy How To

詳細パッチレベルファイルはサポートエンジニアがLiferayの稼働環境構成を把握するうえで非常に重要なファイルです。このページではそのパッチレベルファイルの取得手順を説明します。 Resolution 前提最新のサービスパックの「Bundled with Tomcat」を任意のディレクトリへ展開済みとする以下、展開済みのライフレイのディレクトリを「<LIFERAY_HOME>」と記する取得の流れコマンドラインで<LIFERAY_HOME>/patching-tool/ディレクトリへ移動 ./patching-tool.sh...

Migrating Your Database to PostgreSQL

How To

Introduction Liferay adopted PostgreSQL as the default database for PaaS and SaaS projects in October 2024. Since then, all new Liferay PaaS and SaaS deployments use PostgreSQL. To maintain compatibility and ensure optimal performance, consider migrating your existing databases. This...

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 completes successfully, a multidomain certificate is generated for all...

Will page comments be deleted after time or when reaching a storage limit?

legacy

Issue Are there any settings that regulate retention of comments? In other words, how many comments can be stored for a page before they are deleted automatically? Environment DXP 7.2 Resolution There is no automated 'housekeeping' function that deletes old comments or any maximum limit...

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 have defined in apache two servers with the appropriate re-directions,...

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 the displayed article, I receive a JS error, and after refreshing the...

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 Clearing the osgi/state, tomcat_home/work and temp directories does not...

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 same LAR file are imported and displayed correctly. Environment Versions...

How to View Highlighted Changes for Pages in a Publication

legacy How To

Issue When reviewing changes for a page within a Publication, it is not immediately clear how to view the highlighted differences (additions/deletions) in a unified view, similar to the functionality available for Web Content. Environment Liferay DXP 2025.Q1+ Resolution Liferay DXP...

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 modifying and saving an existing structure that contains a field group. As a result, the...

SCIM Support for Microsoft Entra ID

legacy

Issue Is there complete out-of-the-box SCIM support for Microsoft Entra ID in Liferay DXP? Environment Versions before 2025.Q2.0. Resolution Full support for Microsoft Entra ID with Liferay's SCIM functionality was introduced in the 2025.Q2.0 release. Prior versions, including 2025.Q1,...

Publication shareable link and email link do not automatically select the publication that needs work/review

legacy

Issue When using publications and collaborating with other users. The link shared via publication email does not select the publication that needs reviewing/collaboration. The user needs to manually select the publication from the list of publications. If there are many publications that...

User ID's and Emails populating due to SSTI vulnerability

legacy Troubleshooting

Issue We've found an undesirable behvavior when using new widget templates on a page. When using the expandoColumnLocalService.CTPersistence.openNewSession(null) function, the the direct SQL query execution within the template itself, bypasses the standard access controls and exposes...

Is it possible to configure a custom page for the 403 error using Utility Pages?

legacy

Issue I am trying to add a new Utility Page for a 403 (Forbidden) error, but the only options available are for 404 (Not Found) and 500 (Internal Server Error). I would like to know if it is possible to create a custom error page for the 403 error using the Utility Pages feature....

Client Extensions not working on Non-Primary Virtual Instances on PaaS

legacy Troubleshooting

Issue When deploying Client Extensions (CX) to a Liferay PaaS environment with multiple virtual instances, the CSS and JavaScript files for extensions on non-primary instances fail to load. This results in unstyled components and 404 errors in the browser console for these resources....

Is it Possible to Require an Administrator to Enter Their Password When Changing a User's Password?

legacy

Issue When I want to updates a user's password as an administrator, the system does not require to re-enter my own password for authentication. This is inconsistent with other actions, such as updating a screen name or email address, where password verification is required. Is it...

This version of MySQL doesn't yet support 'existing primary key drop without adding a new primary key

legacy Troubleshooting

Issue We are upgrading from liferay-dxp-tomcat-2023.q4.4 to liferay-dxp-tomcat-2025.q1.15-lts. Currently we are using Mysql 8.0.41-azure on our server which is compatible with liferay-dxp-tomcat-2025.q1.15-lts. Liferay Version: 2025.Q1.15 Database: MySQL 8.0.41-Azure Upgrade Tool:...

How to Migrate from Advanced File System Store to Google Cloud Storage

legacy How To

Issue When using the Advanced File System Store for the Document Library, what is the correct procedure to migrate to Google Cloud Storage (GCS)? This includes understanding if the migration is a direct process and whether file transfers are manual or automatic. Environment Liferay...

Customizing pagination delta values at instance/site level

legacy How To

Issue The pagination options for search results (e.g., the number of items displayed per page) are controlled globally by the search.container.page.delta.values property in the portal-ext.properties file. Since this configuration affects the whole environment, Is there any alternative or...

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 all fieldsets adhere to a specific naming convention, which may not...

Is it possible to disable the '/o/graphql' endpoint?

legacy How To

Issue For custom requirements, it may be necessary to disable the /o/graphql endpoint. Is there an out-of-the-box configuration to disable this endpoint? Environment Liferay DXP 7.3, DXP 7.4 and Quarterly Releases. Resolution There is no out-of-the-box property or configuration to...

"Friendly URL is Already in Use" Error Message Lacks Specifics on its Location

legacy

Issue When creating or updating a page, if a user enters a friendly URL that is already in use by another page, the system displays a generic error message: "The friendly URL is already in use." This error message does not provide any information about which page or entity is currently...

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 Resolution This behavior has been addressed and fixed in LPD-59412 and...

Document URL Displays Virtual Instance Domain Instead of Site Virtual Host

legacy

Issue I've configured a Site with its own Virtual Host (www.b.com), but when I upload a document to that site, the document's URL incorrectly displays the parent Virtual Instance's domain (www.a.com). I expected the URL to use the Site's configured Virtual Host (www.b.com) instead....

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 indicates a duplicate entry for a key in the Repository table....

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 themes and templates. Please examine the themes and master template...

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 Resolution The recommended solution is to request a hotfix from Liferay...

Can Terms Of Use be Configured at the Site Level?

legacy

Issue If we have two or more sites, is it possible to specify a different journal article for the terms of use of each site? As the following current custom properties are not sufficient as they apply to every site: terms.of.use.journal.article.group.id= terms.of.use.journal.article.id=...

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, legacy: true, name: Web Content Templates cache Absolute image URLs, not...

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 Liferay includes React by default, this issue may occur if your DDM field...

Can Angular Portlets be crawled by SEO tools/Google?

legacy

Issue Can Angular Portlets be crawled by SEO tools/Google? Environment Liferay DXP any Resolution By default, Angular Portlets in Liferay are not SEO-friendly and cannot be easily crawled by search engines like Google, because: Client-Side Rendering (CSR) Angular is a Single Page...

Issue with Display Page Template URL for Web Content Articles

legacy

Issue I have an issue with the Display Page Template URL. I have configured a Display Page Template named "Test News" to display the full article data for web content articles of type News. I assigned the friendly URL /test-news to the template. Our setup: The display page template is...

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 configuration cannot be found in the Site Pages UI, the Friendly URL History, or...

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 second page, when they select the private page to link it, the page...

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 template project contains a liferay-look-and-feel.xml file, which causes Liferay to classify...

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 users are removed from LDAP server using this method, they are also...

Why did Cache-Control change from 'public to 'private'?

legacy

Issue Prior to 7.4 U84, Cache-Control was set to 'public', and after upgrading to 7.4 U84 or above (including any Quarterly Release version), Cache-Control is now set to 'private'. Due to this, CDNs may have issue caching JavaScript and CSS. Environment DXP 7.4 Quarterly Release...

Configuring Product Visibility Across Channels with Headless API in Liferay Commerce

legacy How To

Issue Is it possible to manage (assign/ remove) product visibility per channel using the Headless API? Environment Liferay DXP 2024.Q4 Resolution By default, products are visible across all channels. This visibility can be configured in two ways: either using the Liferay UI or via the...

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 theme id classic_WAR_classictheme. Returning the default theme. This issue happens when...

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 user that meets all criteria Example Steps to Reproduce: When in a site,...

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 "google") Save changes Go to Site Configuration Verify that the Analytics...

Chart Taglib is Unavailable in Liferay DXP 2025.Q1 and Later

legacy How To

Issue After upgrading to Liferay DXP 2025.Q1, custom modules that use the Liferay Chart Taglib fail to build or deploy. The build process may fail with an error indicating the chart library cannot be found: Could not resolve all files for configuration...

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 image.default.company.logo already exists. ERROR [main][UpgradeExecutor:333] A folder...

"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: java.lang.reflect.InaccessibleObjectException: Unable to make field static final...

Does Liferay have an Attestation of Compliance to be PCI certified?

legacy

Issue We are in the process of reviewing application compliance and want to know if Liferay has an attestation of compliance (related to PCI), specifically the Payment Card Industry Data Security Standard? Environment DXP 7.2 Resolution Liferay is not a payment card platform and...

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 after being received and the configured password reset link duration has not...

How can I protect against CVE-2025-4388 vulnerability?

legacy Troubleshooting

Issue My Liferay Instance has a vulnerability to CVE-2025-4388 Environment Liferay DXP 7.2 Liferay DXP 7.3 Liferay DXP 7.4 Resolution Upgrade to 2024.Q1.13+ Request a Hotfix with LPD-46038, knowledgeArticleType: troubleshooting, legacy: true, name: How can I protect against CVE-2025-4388...

Public resources under /o/

legacy How To

Issue Why /o/marketplace-app-manager-web/icon.jsp is public by default? Are there any other out of the box resources publicly available by default? Environment Liferay DXP any Resolution The Marketplace module is an out-of-the-box Liferay module. As long as it remains deployed (e.g. not...

Searching in a page created from a content page template does not work

legacy Troubleshooting

Issue I have an issue with searching in pages created from the content page template. When I search in a page and filter to "Pages", nothing happens in the page, and there are no search results. Steps to reproduce Start 2025.q1.14-lts Go to Design > Page Templates Add a new Page Template...

What filtering syntax to use in headless API for filtering for those entries that do not belong to any categories?

legacy

Issue I am using the API GET /v1.0/asset-libraries/{assetLibraryId}/content-elements, but the question might be relevant for other endpoints as well according to https://learn.liferay.com/w/dxp/low-code/objects/understanding-object-integrations/using-custom-object-apis/object-api-basics...

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 [org.hibernate.StaleStateException: Batch update returned unexpected row count from...

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 Release, 2024.Q4 Resolution Request for a hotfix containing LPD-56468. An...

How to Configure Liferay DXP Logs in JSON Format

legacy How To

Issue How can Liferay DXP be configured to generate logs in JSON format instead of the default plain text format? This is often required for integration with modern log aggregation and analysis tools. Environment Liferay DXP Resolution Liferay DXP uses Apache Log4j 2 for its logging...

Translated Object Field Values Not Displaying in Page SEO Meta Tags

legacy How To

Issue When using an Object with translatable fields for a page's SEO settings (e.g., HTML Title and Description), the translated values do not appear in the page's meta tags. For example, when viewing the page in Arabic, the meta tags in the page's source code still display the English...

Integrating Liferay as a Mobile App

legacy

Issue I want to export my Liferay web instance into an Single-Page-Application (SPA) or a standalone native mobile App. Environment Liferay DXP 7.4 Quarterly Releases Resolution Currently Liferay doesn't support out-of-the-box transition to Mobile Apps. The only available solution is to...

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 Content-Type header. Environment 2024.q1.17 Resolution Request a hotfix...

Search Results