Site Search - Liferay Learn

Configuring OAuth2 for Message Board Mailing Lists

Issue Basic authentication for emails is no longer available for Gmail, can we use OAuth2 connection with them? Google Workspace has announced that third-party apps that use only a password to access Google...

Publication to live fails with an error like "Portlet export failed for portlet com_liferay_exportimport_web_portlet_ChangesetPortlet com.liferay.exportimport.kernel.lar.PortletDataException: No Layout exists with the primary key xxxxx"

legacy Troubleshooting

Issue Publication to live fails with an error like: 2025-04-24 13:42:15.663 ERROR [liferay/background_task-8][LoggerExportImportLifecycleListener:226] Portlet export failed for portlet...

Liferay Dropdown Functionality isn't working properly

legacy Troubleshooting

Issue We've discovered an undesirable behavior when using the Liferay drop-down menu. Steps to reproduce: Content Page > Edit > Insert a "HTML" fragment and double click on the fragment Attach the following html...

Can't to edit files in Google Drive or Office 365 in non-production publications

legacy Troubleshooting

Issue When I try to edit a document through Google Drive or Office 365 in a non-production publication, I see a notification in the UI that says "Error: This action can only be performed in production mode."...

Unable to Publish Web Content with Error "RangeError: Invalid time zone specified"

legacy Troubleshooting

Issue After upgrading to 2025.Q1.5, any user with the time zone (UTC +10:00) Australian Eastern Standard Time is unable to publish Web Content. After clicking Publish with Permissions, the user remains on the...

How to Connect Documents and Media to a Local File System Using a WebDAV URL

legacy How To

Issue Steps to connect the WebDAV URL with your local machine's file system. Environment DXP 7.4 and above DXP 2023.Q4.0 and above Resolution For Fedora and Linux Machines (Before 2023.Q4.0): Navigate to Documents...

AntiSamyモジュールを無効化しても、Webコンテンツにタグを貼り付けた際、属性が自動的に削除される

legacy Troubleshooting

問題 Webコンテンツを編集時に、タグを貼り付けると、タグの属性が自動的に削除されてしまいます。一例として、 <p oncontextmenu="return false;">Test</p> をペーストすると、 <p>Test</p> に自動的に変更されます。 Webコンテンツの入力のサニタイズは、AntiSamyモジュールにより行われているのは既知だが、...

Intermittent Digit Loss in Liferay Form Confirmation Field

legacy Troubleshooting

Issue I'm experiencing an issue where digits are unexpectedly removed when quickly typing numbers into a confirmation field within a Liferay Form. Steps to Reproduce: Create a new Liferay Form. Add a numeric field...

Resources Not Displaying Correctly in Page Fragments

legacy Troubleshooting

Issue Page fragments that use resources with Freemarker variables in their URLs do not display correctly when the fragment is viewed on a page. <#assign varResource = "resourceName"/> <img...

Cannot Deploy a Portlet to a Widget Page

legacy Troubleshooting

Issue After deploying a portlet, I'm not able to move it to a widget page. Adding portlets from WAR fails due to the permission checking logic in UpdateLayoutStrutsAction javax.servlet.ServletException:...

PATCH Object Request Fails With Mandatory Vocabulary

legacy Troubleshooting

Issue When trying to perform a PATCH request on an object instance to update a field, if the object has a required vocabulary, the request fails with the following error: { "detail": "Select at least one taxonomy...

Module/Theme data persists after undeploying it and clearing cache

legacy Troubleshooting

Issue After removing a deployable module, some of its data can persist despite clearing the cache which includes the osgi/state folder, and all temp and work directories. For example, after removing a custom theme, its...

Unable to cast String to Long error during upgrade

legacy Troubleshooting

Issue When upgrading from Liferay DXP 7.2 to 2025.Q1, setting the fileMaxSize property in the com.liferay.document.library.configuration.DLConfiguration.config file causes an "Unable to cast String to Long"...

Changing the site logo

legacy How To

Issue How do I change my site's logo in 7.4? Environment 7.4 Resolution Open the Site Menu () and navigate to Site Builder → Pages. Click Options () in the Application Bar and select Configuration. Under Logo,...

Erratic behavior when using pagination in Documents and Media

legacy Troubleshooting

Issue When listing documents in Documents and Media section, some files are missing or duplicated when using pagination. The same can happen in other sections as well, such as Web Content. Environment DXP 7.3 DXP 7.4...

"Missing 'Date Modified' and 'Date Created' Fields in Object Display Page Template Mapping

legacy Troubleshooting

Issue We have a Display Page Template defined for an Object (Documents - Simple Document). In the edit mode, in the list of available variables of the mapping fields, the Date Modified and Date Created fields are...

How do I renew expired SAML certificate?

legacy

Issue We just noticed while browsing through the admin settings that apparently our SAML certificate expired four months ago, but our SSO and login works with no issue. We use Azure AD (Entra) for the Identity Provider...

Organization's users exposed in UI when modifying groupID in Request Body

legacy Troubleshooting

Issue An organization's member list can be seen by manipulating the role member assign(groupID) in a request. Here are the steps to reproduce: Setup browser proxy to 127.0.0.1:8180. For example with Chrome, navigate to...

Fragments and Fragment Compositions Share Permissions

legacy

Issue We want to create a role where a user can have granular control of the layout of a page by creating and editing Fragment Compositions, but not the ability to create or edit fragments themselves, how...

How to map Liferay site roles with Azure AD

legacy How To

Issue How to map Liferay site roles to Azure AD roles when configuring SAML? For example, if there is a role called Content Author under site roles, how to configure this role in Azure AD? Environment Liferay...

Password Reset Link Breaks After Language Change

legacy Troubleshooting

Issue After adding users from the portal, users receive an email to create their account password. This email contains a password reset link. Clicking the password reset link opens a page to reset the...

Managing Temp Files in Tomcat

legacy Troubleshooting

Issue How temp files in Tomcat are handled? Do they get deleted automatically after the file upload is successful? Environment Liferay DXP 7.4 Resolution Temporary Files During Upload – Documents and Media:...

Dataset Column Widths Incorrect on Tab Change

legacy Troubleshooting

Issue When displaying multiple data sets on a page using the Tabs element, the columns break. They appear crammed to the left side, the columns are no wide enough to display the data. Steps to reproduce: 1. On...

Multiple unsatisfied references when installing a hotfix in 2024.Q4.5 or 2024.Q4.6

legacy Troubleshooting

Issue After installing a hotfix in 2024.Q4.5/6, multiple unsatisfied references appear. It may appear in the start up logs or when running ds:unsatfisfied from the Gogo Shel: 2025-04-21 14:50:53.948 WARN...

ClassCastException during upgrade when setting maximum file size using config file

legacy Troubleshooting

Issue During the upgrade process from Liferay DXP 7.2 to 2025.Q1, a ClassCastException occurs when setting the maximum file size using the OSGi configuration file...

Documents and Media files are not loading after setting up a 2nd cluster node

legacy Troubleshooting

Issue Documents and Media files are not loading after setting up a 2nd cluster node. This does not affect the 1st node, and only occurs on node 2. Environment Quarterly Release DXP 7.4 DXP 7.3 Resolution Since the...

Hindi Month Names Are Truncated in Search Results

legacy Troubleshooting

Issue After adding the JVM argument -Djava.locale.providers=CLDR, long month names in Hindi get truncated in search results. Example: "सितंबर 07, 2001" to "सितं 07, 2001" Environment Liferay DXP 2023.Q4 Resolution...

How to Set the Limit of Pages to Preview Documents in SaaS enviroments

legacy Troubleshooting

Issue The “Set limit of number of pages to preview” functionality is not working after configuring it on the Instance Settings level. Environment Liferay SaaS Resolution For SaaS customers, it is necessary to first...

Incorrect Price on Catalog Page and PDP(Product Detail Page)

legacy Troubleshooting

Issue The Product Listing Page (PLP)/Catalog Page shows the correct minimum price, but the Product Detail Page (PDP) shows a different price based on the quantity values. Catalog Page/PLP: Product Detail Page...

SAML Certificate Deleted After Restarting Liferay DXP on Kubernetes

legacy Troubleshooting

Issue Configured SAML in Liferay. The SAML certificates are deleted when the Kubernetes pod (Liferay server) is restarted. Environment DXP 2023.Q4.0 Resolution The SAML certificate is stored at /opt/liferay/data/. In...

Timeout 504 Error During Multiple File Downloads via POST Method

legacy

Issue If a CloudFront layer is present in front of Liferay DXP, while downloading large files, might encounter a failure timeout 504 error. Specifically, when attempting to download multiple files, Liferay...

Inconsistent Image/Document Loading after upgrading to DXP 7.4U80+ due to S3 connection timeout

legacy Troubleshooting

Issue After upgrading to 7.4U80+ / Quarterly Releases, images and documents are not loading consistently, sometimes resulting in a 400 error. You may see the following error or a similar one in the...

Blueprints Display External Reference Codes (ERC)

legacy

Issue After updating Liferay, Blueprints configuration now displays External Reference Codes (ERC) next to the categories, sites and other elements. Environment 2024.Q4+ Resolution This change was implemented in...

Web Content filtering and sorting based on Date and Time with API

legacy

Issue I'm using the Headless API endpoint /v1.0/content-structures/{contentStructureId}/structured-contents I want to filter or sort structured content by the date and time field. The results are incorrect and do not...

Backend Functionalities and SVG Icons Fail When Using a CDN

legacy Troubleshooting

Issue After setting up a CDN for static resources, some backend functionalities, such as buttons and dynamic functionalities, stop working. Browser console displays CORS errors when trying to access...

Order by Last Login Date not Arranging Users in the Correct Order

legacy Troubleshooting

Issue In the Users & Organizations pane, when I sort users by last login date the users are not arranged in the correct order. Environment Liferay Quarterly Release Resolution In System Settings > Feature Flags...

Web Content Display and Edited Fragments Disappear after Publishing

legacy Troubleshooting

Issue We've experienced an undesirable behavior when using Web Content Display and Fragments. After publishing the Web Content Display and going back to edit, the changes made from the edit are not saved. Steps to...

Appending Query Parameters to Liferay's OIDC Redirect URL

legacy

Issue Is it possible to append query parameters to the end of the out-of-the-box redirect parameter provided by Liferay to the OIDC provider (https://[server.domain]/c/portal/login/openidconnect] Environment...

How to Remove Owner Role Permissions?

legacy

Issue We have users who had Site Admin role on one of their Sites and created a Page/Asset. After we revoked their Admin role (but not the Site Membership, so they can still access the Site), they continue to have...

Document's viewCount Not Updating when Viewing it in Documents and Media

legacy

Issue Liferay's default Document and Media portlet allows users to open files directly within the portlet. However, the view count for these documents isn't registered in the database unless the user downloads the...