Site Search - Liferay Learn

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

Rest Application menu (/o/api) contains duplicate items

legacy Troubleshooting

Issue I have noticed that when I use the headless /o/api Rest Application menu has duplicated items. It is duplicated next time after being selected and used. It does not impact the functionality. Reproduction Steps:...

Display date disappears if you update a web content

legacy Troubleshooting

Issue I have an issue with the web content article display date. When I update the web content by changing the title, the published date disappears. Reproduction Steps: 1. Start 2025.q1.8-lts 2. Go to Content & Data...

Liferay service restarts frequently

legacy Troubleshooting

Issue Since we allowed access to some users to contribute content, we are getting many issues with Liferay service restarts. While we are working with the platform, following error message is shown without any...

NoClassDefFoundError: org/apache/commons/compress/archivers/zip/ZipArchiveInputStream

legacy Troubleshooting

Issue We are putting up commons-io on osgi/module folder so it will be readily available to all modules, on our previous version of Liferay (DXP 2024 Q1.7), the commons-io worked, however now we are updating to the latest...

Analytics Cloud Stuck On "Redirecting to your identity provider..."

legacy Troubleshooting

Issue When attempting to access Analytics Cloud via https://analytics.liferay.com the site hangs indefinitely on the "Redirecting to your identity provider..." message. This can occur despite successfully logging...

User Workflows Not Appearing Under 'Assigned to My Roles'

legacy Troubleshooting

Issue We have enabled a workflow for approving new user account creation. While the Admin user gets the notficiation about the workflow task, if they navigate to My Workflow Tasks > Assigned to my Roles, the task is...

Loss of Client Extension Configurations After Publishing with Local Staging

legacy Troubleshooting

Issue After configuring settings such as JS or CSS on the pages of a site with Local Staging enabled, the changes are being lost after publishing to Live Environment 2024.Q1.12 (or older versions) Resolution This...

After upgrading to 2025.q1. old display date is not set as publication schedule date

legacy Troubleshooting

Issue When upgraded to 2025.q1.2 the display date was still there in the database, but when you checked the UI clicking on Schedule Publication, you could not see the date set for display on the previous Liferay. ...

OHS IP Appended to Image URLs on One Application Server Node

legacy Troubleshooting

Issue Inconsistent behavior is observed between two application server nodes with identical configurations. One node appends the OHS (Oracle HTTP Server) IP address to image URLs, causing 404 errors, while...

Permissions error when restoring backup

legacy Troubleshooting

Issue We are trying to restore a PRO environment backup into DEV environment. And we see in the log several errors related to Document Library when decompressing: May 05 16:13:15.812 build-3964...

Users are redirected to the Document Library home folder after interacting with a document

legacy Troubleshooting

Issue After interacting with a document in a sub-folder withing the Document Library, users are redirected back to the Document Library's home folder. Environment Quarterly Releases Resolution This issue has been...

Error uploading file: ClassCastException: class com.liferay.portal.repository.liferayrepository.model.LiferayFileEntry cannot be cast to class com.liferay.portal.kernel.model.BaseModel

legacy Troubleshooting

Issue I get an error like this in the logs when uploading a file: Caused by: java.lang.ClassCastException: class com.liferay.portal.repository.liferayrepository.model.LiferayFileEntry cannot be cast to class...

Changes to Site Templates are not propagated to pages

legacy Troubleshooting

Issue Changes made to a site template are not propagated to the pages that use the template. We can see the next error in the server log: [LayoutSetPrototypeMergeBackgroundTaskExecutor:219] Merge fail count...

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

The Product Menu Becomes Unresponsive after Upgrading to 2024.Q3 when module.framework.properties.org.osgi.framework.bootdelegation is configured

legacy Troubleshooting

Issue After upgrading to version 7.4 2024 Q3.6. the product menu becomes inaccessible and resulting in an exception at the backend. This happened after copying the...

Custom CK Editor toolbar is registered but not displayed

legacy Troubleshooting

Issue We followed this blog post to create a custom CKEditor 4 module in workspace. We can see that CKEDITOR.plugins.registered but, we are not able to see it on the CK Editor toolbar UI in Liferay 7.4...

Brave log-correlation issue

legacy Troubleshooting

Issue I am using brave (https://github.com/openzipkin/brave) to create a correlation across all logs events from Liferay, portlets and backends. After upgrading from Liferay 7.2 to 2024.Q3.12, which now internally uses...

Slow Performance When Searching for Non-Admin Users

legacy Troubleshooting

Issue Searching for non-admin users causes performance issues that did not exist prior to upgrading to 2024.q1. When non-admin users attempt to search, they receive a timeout error. Performance issues in...

"Lambda expressions are allowed only at source level 1.8 or above" warning occurs in the logs

legacy Troubleshooting

Issue The following warning occurs in the logs while configuring the WebSphere application server with Liferay. WARN [WebContainer : 4][code_jsp:162] {code="500", msg="JSPG0049E: /html/common/themes/top_head.jsp...

javax.mail.Provider: com.sun.mail.imap.IMAPProvider not a subtype

legacy Troubleshooting

Issue I am encountering the following error when attempting to send emails using Jakarta Mail (version 2.0.1) within my Liferay environment. javax.mail.Provider:com.sun.mail.imap.IMAPProvider not a subtype...

Hardcoded Text in Commerce Order Importer Not Translatable

legacy Troubleshooting

Issue Allow hiding the non-required options from CSV template message. We have this csv_template.csv file and sometimes we need to edit its content to remove non-used fields, like requestedDeliveryDate that is...

I cannot add a parent page in Menu Display using the Pages Hierarchy

legacy Troubleshooting

Issue I have an issue with the Menu Display Widget. When I try to select a parent menu in the configuration tab, the preview doesn’t change and after saving the configuration the Pages hierarchy is reset. Reproduction...

Radio Buttons in Forms cannot be navigated by keyboard

legacy Troubleshooting

Issue I have set up a form with non-inlined radio button groups. Using tabulator and arrow keys, I cannot select the appropriate option within groups. This is an accessibility issue, since the form cannot be...

Special characters like apostrophe (') is displayed as its ASCII value in the account address field

legacy Troubleshooting

Issue Special characters like apostrophe (') are displayed as their ASCII value in the account address field. Steps to Reproduce: Start Liferay DXP 2024.Q1.12 Go to Control Panel -> Accounts Create an...

Pagination Numbers Displayed in Hindi Numerals When Language is Switched to Hindi

legacy Troubleshooting

Issue When switching the language from English to Hindi, the numeric values in the pagination control change to Hindi numerals. Environment Liferay DXP 7.4 Quarterly Release 2023.Q3 Resolution This issue...

ClassCastException When Adding Web Content in Batch via Headless API

legacy Troubleshooting

Issue When attempting to add web content in batch using the headless API endpoint /o/headless-delivery/v1.0/sites/{siteId}/structured-contents/batch, a ClassCastException occurs. The error resembles the...

Are Document Previews in Liferay Compatible with '.potx' File Extensions?

legacy Troubleshooting

Issue We are facing an issue with the preview of files having '.potx' extension. We added the extension in System Settings > Documents and Media > Service and System Settings > Documents and Media > Item Selector View....

After upgrading to DXP 7.4 u92 I receive an unable to locate transaction executor error on server startup

legacy Troubleshooting

Issue I have an issue with deploying our custom built Java modules. I upgraded from DXP 7.4 update 81 to u92. After the upgrade, on server startup the deployment of the custom built modules behavior is inconsistent and...

Using the "ehcache.multi.vm.config.location" property, the "java.lang.NullPointerException: Configuration Path is Null" error occured

legacy Troubleshooting

Issue After configuring the "ehcache.multi.vm.config.location" property in portal-ext.properties, the following errors occurred. ERROR [SCR Component Actor][ROOT:47] bundle...

Error: HikariPool-1 - Failed to validate connection org.postgresql.jdbc.PgConnection@xxxxxx (This connection has been closed.). Possibly consider using a shorter maxLifetime value

legacy Troubleshooting

Issue Facing the following error in the logs and the Liferay node became unresponsive: HikariPool-1 - Failed to validate connection org.postgresql.jdbc.PgConnection@6c009ca1 (This connection has been...

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

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

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

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

Is it possible to use wildcards with virtual hosts?

legacy Troubleshooting

Issue We are using Azure and we set the virtual hosts in the portal-ext.properties with virtual.hosts.valid.hosts with oursite-xxxx.region.azurecontainerapps.io We receive a blank landing page like this because the...

How to reference static assets by URL from a client extension on SaaS?

legacy Troubleshooting

Issue I am trying to use static assets (images) from the test-theme-css client extension that I deployed. When running the project locally, I am able to do this, but on SaaS, the URL does not work. Local 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...

NullPointerException when evaluating AuthLoginGroupSettingsUtil.isPromptEnabled

legacy Troubleshooting

Issue The following error is thrown in the logs every once in a while: 2024-07-29 06:55:37.018 ERROR [http-nio-8080-exec-7][CTCollectionPreviewFilter:53] java.lang.NullPointerException...

How to resolve "From address not allowed" email errors in a Liferay SaaS environment

legacy Troubleshooting

Issue In our SaaS environment, email notifications are failing when the "From Address" domain does not end in "@lxc.app" in our notification template for creating objects (even after adjusting the "Email Sender"...

Custom module fails to start with error "Stopping blacklisted bundle"

legacy Troubleshooting

Issue I have deployed a custom module, but it is failing to start and does not work. The logs show this message: Stopping blacklisted bundle my-custom-portlet_1.0.0 Environment Liferay DXP 7.4 Liferay PaaS...

"Unable to persist buffered increment value" Error in Liferay Logs

legacy Troubleshooting

Issue I am seeing the following errors thrown regularly in my Liferay console logs. How can I resolve this? ERROR [BufferedIncrement-default-2][BufferedIncrementRunnable:54] Unable to persist buffered increment...

How to resolve "Attempting to upgrade table UserGroupGroupRole by adding a temporary column" DB2 database upgrade errors

legacy Troubleshooting

Issue When trying to upgrade Liferay DXP from a 7.4 U release to 2024.q1.3 using a DB2 11.5 database, we encountered the following errors relating to the UserGroupGroupRole table: INFO [ServerService Thread Pool --...

Database connection issue: Failed to validate connection

legacy Troubleshooting

Issue We are getting some slowness when browsing through DXP and following message is showed in log: HikariPool-1 - WARN … Failed to validate connection … Possibly consider using a shorter maxLifetime value....