title

HTTP 403 when accessing headless admin taxonomy API

Issue 403 Forbidden error when accessing the following Headless API: GET /o/headless-admin-taxonomy/v1.0/taxonomy-vocabularies/{VocabularyID}/taxonomy-categories Environment Liferay DXP 2025.Q2 Resolution Go to the...

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

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

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

Why is the Product Specification Key Different from the One Defined in the Specification List?

legacy

Issue When creating a product specification, a key is defined under Product Management > Specifications. However, after adding this specification to a product, the Product Specification widget on the product page...

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

Liferay AI capabilities

legacy

Issue We would like to gain more information about Liferay's AI capabilities. Environment Liferay DXP Quarterly releases Resolution Liferay DXP integrates with external AI systems to enhance and accelerate your...

Seperate SSL for virtual instances

legacy How To

Issue We have multiple SSL certificates and want to use them in virtual instances that run under a different domain from the main instance. Environment DXP 2024.Q3 Resolution If behind a reverse proxy, configure...

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

Does Liferay support IPv6?

legacy

Issue Does Liferay support IPv6? Environment Liferay QR Resolution We plan to support IPv6 at the load balancer level using a dual-stack approach. While this requires some development on the Liferay side,...

Application Accept Special Characters in Input Fields

legacy

Issue The application accepts special characters in input fields. Ex: " ' ` * ; % _ = & | \ ? ~ < > ^ () [] {} $ \n\ Steps to Reproduce: 1. Start Liferay server. 2. Navigate to the user’s profile. 3. Click on...

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

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

After Upgrading to 2024.Q1 User Public Pages Return 404 Error if Accessed via PlId

legacy How To

Issue After upgrading from Liferay DXP 7.4 u48 to 2024.Q1, user public pages with guest permissions return a 404 error, except for the page owner. The portal administrator also cannot access these pages. Environment...

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

JavaScript code in Link to URL page gets executed

legacy How To

Issue When creating a new public page of type "Link to URL" and using JavaScript code as the URL, the code gets executed when accessing the page. Environment Liferay DXP 2025.Q1 and prior Quarterly Releases Resolution...

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

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

Is Liferay affected by CVE-2024-6783?

legacy

Issue After performing a security scan, a Vue.js vulnerability reported as CVE-2024-6783 is identified. Environment Liferay DXP 7.4 - Quarterly Releases Resolution Liferay is not impacted by CVE-2024-6783 as Liferay DXP...

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

Deploys failing due to "requested flag is either misspelled or unsupported by this database type"

legacy Troubleshooting

Issue New deploys fails due to the database service and backup restores too Checking the database service logs you identify the following: INFO May 15 14:54:39.664 1904 database 75b864bd48-zzc6n [INFO] Instance...

Web Content is being approved after the expiry date

legacy

Issue When users enable workflow for web content, the expiration date feature is not working as expected. Steps to reproduce: 1. Start the server 2. Apply 'Single Approver Workflow' for web content. 3. Navigate to...

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

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

Error in Jenkins builds

legacy Troubleshooting

Issue When we generate a new build, we get the following error: ERROR: the command "[lcp, deploy, --only-build, --project, resumed, --metadata,...

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

How to expose large object entries to guest users without manually assigning the permissions

legacy How To

Issue How to expose object entries to guest users without manually assigning permissions to each entry. Assigning permission will work here but if the number of entries in the object is large, it will not be...

GMT Unexpectedly Appears in Time Zone Dropdown

legacy Troubleshooting

Issue I'm trying to customize the default list of time zones in Liferay DXP by setting the time.zones property in the portal-ext.properties file. I didn't include GMTin the configuration, but it is still showing...

Error Code 403 Forbidden: Timeout Issues when uploading/downloading Large Files to S3

legacy Troubleshooting

Issue Experiencing timeout and permission issues when uploading/downloading large files (in GBs) using Liferay's simple file system. ERROR [http-nio-0.0.0.0-8080-exec-41][PortletServlet:109] Unable to process...

Warning in logs: "No theme found for specified theme id" after uninstalling a theme

legacy Troubleshooting

Issue After migrating, the following warning appears in the logs: 2025-05-19 08:51:53,593 WARN [ajp-nio-10.10.13.111-8009-exec-83][ThemeLocalServiceImpl:220] No theme found for specified theme id...

Error in Logs When Accessing "OAuth 2 Administration" in Control Panel

legacy Troubleshooting

Issue When clicking on the "OAuth 2 Administration" option in the Control Panel, the following error is logged, and the UI displays an unresolved Velocity variable (${processor.processMax()}): Unable to execute...

After changing image file extension it is no longer visible for selection within a fragment

legacy Troubleshooting

Issue Our team recently noticed that they can't use PNG files anymore and can reproduce it by: Upload PNG file to Documents and Media library (please note that after page refresh Liferay does not show an image preview)...

Configuring the "Module Definition Timeout"

legacy How To

Issue We needed to programmatically configure the "Module Definition Timeout (seconds)" setting found under System Settings > Infrastructure > JavaScript Loader in the Liferay UI. Specifically, we were looking for a...

Document Checkin and Cancel Checkout fails when using Office 365

legacy Troubleshooting

Issue When I try to check a document in or cancel checkout, it always fails on the first attempt. I see these errors in the logs com.liferay.portal.kernel.log.LogSanitizerException:...

Workflows are missing from Applications → Process Builder

legacy Troubleshooting

Issue Some workflows are missing from Applications → Process Builder. I have publications enabled in my environment, and I have edited workflows from withing the publications. Environment Quarterly Releases...

How can you ensure that users from User Groups are properly imported when using LDAP Active Directory with Liferay?

legacy Troubleshooting

Issue Ensuring that User-Groups users are properly imported when using LDAP Active Directory with Liferay. Environment Liferay DXP 7.4 Resolution To ensure proper user imports and updates, the User Group...

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

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

Tomcat download error encountered when leveraging Liferay Developer Studio / IDE

legacy Troubleshooting

Issue When leveraging Liferay Developer Studio / IDE to build Liferay 2025.Q1.3, my build fails with indications that Tomcat is not able to download Example error: Execution failed for task...

External Document Management Tool Integration Fails When a Vocabulary is Required

legacy Troubleshooting

Issue I'm unable to create a new document in Google Drive or Office 365. After editing documents in Google Drive and navigating back to Liferay, the Liferay UI breaks. I currently have at least one Vocabulary...

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

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

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

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

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

Liferay DXP + JBoss EAP 8 Compatibility FAQ

legacy

When will Liferay Support JBoss EAP 8.0? Our team is actively working on making Liferay compatible with JBoss EAP 8. Upgrading to JBoss EAP 8 will require migrating to a newer version of Liferay DXP that supports...

URL scheme must be "http" or "https" for CORS request

legacy Troubleshooting

Issue CORS errors "Failed to fetch" when accessing headless APIs through the API Explorer. Environment Liferay DXP 7.4 Resolution CORS issues arise from mismatches between the origin of the API request and the...

'Unresolved Requirement' error for a custom module post upgrading DXP 7.4 from U24 to U92

legacy Troubleshooting

Issue Receiving the 'Unresolved Requirement' error below for a custom module post upgrading DXP 7.4 from u24 to u92: ERROR [Framework Event Dispatcher: Equinox Container:...

Upgrading Liferay fails with "Data too long for column 'smallAttributeValue'"

legacy Troubleshooting

Issue I am trying to upgrade Liferay to 2024.Q3 or 2024.Q4 The upgrade fails with the following error: 2024-12-17 14:45:21.409 ERROR [main][UpgradeExecutor:333] Failed upgrade process for module...

Configuring Site Locales Using Site Initializer site-settings.json File

legacy

Issue How can I configure site locales using the site-settings.json file within the Site Initializer framework? Environment Liferay DXP 7.4+ Resolution Currently, the Site Initializer framework doesn't support...

Customize Liferay Startup Logo

legacy How To

Issue How to customize Liferay Startup Logo Customization Environment Liferay 7.3 Liferay 7.4 Resolution NOTE: The following resolution requires customization and should only be implemented at the discretion of...

How to Remove Product Attachments via Commerce API?

legacy How To

Issue I need to remove a product attachment by running a script and I am looking for the appropriate Commerce Headless API endpoint to accomplish this. Environment Liferay DXP 2023.Q4.0+ Resolution As of Liferay...

Property "redirect.url.security.mode" has invalid value: domain,domain

legacy Troubleshooting

Issue After setting the property redirect.url.security.mode=domain we are now seeing WARN messages such as Property "redirect.url.security.mode" has invalid value: domain,domain Environment Liferay DXP Resolution Please...

Liferay cluster works when truncating the crashed jgroupsping entries. Why does this happen?

legacy Troubleshooting

Issue When recreating the pod during the pod start-up stage, clustering doesn't work properly, and the below error triggers. But, the Liferay cluster works perfectly post restarting the pods by truncating the entries...

Data providers lead to NPEs during a DXP 7.0 to DXP 7.2 upgrade

legacy Troubleshooting

Issue A Data Provider configured in DXP 7.0 can lead to NullPointerExceptions when upgrading to DXP 7.2 Steps to reproduce: 1. Start Liferay DXP 7.0 server 2. Navigate to Forms -> Data Providers -> Add REST Data...

Service Access Policy configuration file

legacy

Issue Users are unable to export and save the configurations set by the Service Access Policy. Steps to reproduce: 1) Start a clean bundle of Liferay DXP 7.2 2) Navigate to Control Panel -> Configuration -> Service...

Liferay and application server logs are not capturing

legacy Troubleshooting

Issue The Liferay log and application server log are not capturing the stack trace. And the size of these files is 0 in size with 3 to 4 lines of the log being traced. Environment Liferay DXP 7.2 Resolution Please...

During a two-way SSL handshake, an exception is thrown

legacy Troubleshooting

Issue During a two-way SSL handshake, the following exception occurs. javax.net.ssl|WARNING|DC|tomcat-http--46| EDT|SSLSocketImpl.java:1428|handling exception ( "throwable" : { java.lang.NullPointerException at...

Log file size is 0

legacy

Issue Why the other log files size is 0. The files are "host-manager.xxxx-xx-xx.log, localhost.xxxx-xx-xx.log, manager.xxxx-xx-xx.log". Environment Liferay DXP 7.2 Resolution The other log files...

Personalization