Capability

Development and Tooling

Liferay offers a comprehensive toolkit to extend or customize your digital experience. Build applications quickly with low-code/no-code features like Objects, or leverage developer tools like Liferay Workspace and Blade CLI for further customizations.

For users on PaaS or running Self-Hosted, Liferay also offers tools deploying customizations.

Feature
Deployment Approach
Analytics Cloudから、「データをクリア」を実行した場合の動作
, knowledgeArticleType: reference, legacy: true, name: Analytics Cloudから、「データをクリア」を実行した場合の動作, showDisclaimerMessage: true, sourceTeam: Support, ticketNumber: 109488, title: Analytics Cloudから、「データをクリア」を実行した場合の動作
Upgrade to a Quarterly Release Fails with "Elasticsearch sidecar could not be started" Error
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...
In the Documents and Media portlet, the search is not performed on the selected folder in its configuration
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...
Inconsistent Roles in Assign/Unassign Dialogs After Upgrade
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...
"fields" and "nestedFields" Parameter Not Applied to Account System Objects
Issue Using the GET Rest API for account-restricted objects does not seem to follow the `fields` and `nestedFields` parameters for the linked account. For example, when querying a custom object and attempting to...
How to handle Google Fonts locally
Issue For private environments with no access to the internet, we need to handle fonts locally. Environment Liferay DXP Quarterly releases Resolution The recommended way to handle custom fonts (especially in private,...
Client extensions for different business needs
Issue How we can leverage client extensions? Environment Liferay DXP Quarterly releases Resolution As of 2024.Q4 Liferay CLI tool and Liferay Themes Toolkit are deprecated. Instead, a new approach is available....
Multi-Factor Authentication (MFA) email is not being sent for logins
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...
Creating an assetlink and .well-known in PaaS Environment
Issue How can I add an assetlink and .well-known configuration within my PaaS Environment?  Environment Liferay PaaS  Resolution As a PaaS customer, you have the necessary permissions to add files and directories...
Field Group Fields Missing in "Untranslated" View for Non-Default Locale
Issue When we check untranslated field group fields in our web content for the non-default locale, they are not visible. Environment Liferay DXP Quarterly Releases Resolution Contact Support and request a hotfix with...
Error Creating Web Content with Nested Fields via Headless API: 'Value Should Not Be Set for Transient Field'
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...
Company-scoped objects' workflow tasks do not get assigned to users with only site-scoped roles
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...
Updating Web Content's Custom Integer Field Using Headless API
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...
Dynamic Data Lists Changes Not Managed Within Publications in 7.3
Issue Dynamic Data Lists (DDLs) changes are not managed within Publications mode. Any changes or new DDL records are directly published to production. Environment DXP 7.3 Resolution DDL changes are not supported...
Web Content Structures Not Visible in Second Instance After Upgrade
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...
Changing locale using the Language selector in a private page redirects to a 404 error page
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
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...
Web Content Not Visible in Related Asset Window
Issue The user is unable to tag web content to another web content as a related asset with a DB2 database. Steps to reproduce: 1. Navigate to the web content section. 2. Select a basic web content item and create...
Cross-Site Scripting: Reflected
Issue A Cross-Site Scripting (XSS) vulnerability was detected in the web application. Cross-Site Scripting occurs when dynamically generated web pages display user input, such as login information, that is not...
Unable to Create Module for Liferay DXP 2025.Q1.0+ using Liferay Developer Studio 3.10.2
Issue Unable to create module for Liferay Product version 2025.Q1.0 or later using Liferay Developer Studio 3.10.2. Building the JAR file after copying the modules from a lower environment and pasting into...
Builds not deploying to dev environment
Issue Jenkins builds are successfully created, but deployments to the dev environment do not start after clicking "Deploy Build". Direct deployments from Jenkins using LCP_CI_DEPLOY_BRANCH and...
Custom Pagination Override Not Working on WebLogic
Issue Custom JSP (Custom JSP Bag) that overrides Liferay's pagination mechanism to display English numerals is not working as expected on WebLogic Server. The numerals are displayed in the regional...
Callback URL of OAuth2 application created via client extension resets after server restart
Issue After restarting the server, the callback URL for OAuth2 applications created via client extensions, gets reset to the default @protocol@://localhost@port-with-colon@/o/oauth2/redirect, instead of the...
What is causing large temp files to be created?
Issue Some process is creating a large file in the Tomcat/temp directory. These files can be multiple gigabytes in size and grow over a short amount of time and eventually use all the disk space on the servers. ...
Is there a way to customize URLs by Web Content Structures?
Issue We would like to know if there is a way to customize URLs by web content structure for SEO purposes. Currently, friendly URLs for web content use the /w/ separator, which can be customized since 2024.Q2. See...
Sites/Groups Not Searchable in Out-of-the-Box Liferay
Issue We do not see sites as an option while selecting different asset types in the Type Facet portlet as well as in Blueprint configuration. However, we can see in the Liferay source code that SiteAssetRendererFactory...
Changes to Site Templates are not propagated to pages
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...
Form Rules Only Apply on Preview
Issue Form rules don't work when the form is placed on a page, but they do work correctly when previewing the form. Environment DXP 2024.Q4, 2025.Q1 Resolution This issue can happen when publishing a form without...
Error uploading file: ClassCastException: class com.liferay.portal.repository.liferayrepository.model.LiferayFileEntry cannot be cast to class com.liferay.portal.kernel.model.BaseModel
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...
learn-resources.liferay.com:443: Connection reset lines appearing in logs
Issue The following warnings have been appearing in the Liferay logs and need to be removed: INFO [http-nio-8080-exec-2][RetryExec:97] I/O exception (java.net.SocketException) caught when processing request to...
CVE-2025-2565
Issue We would like to know if we are affected by CVE-2025-2565.  Environment DXP 7.4, Quarterly Release, 2023.Q4, 2023.Q4, 2024.Q1, 2024.Q2 Resolution Review Liferay's documentation for 2025-2565 to see if your current...
Users are redirected to the Document Library home folder after interacting with a document
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...
Welcome to Liferay converted to a random paragraph when using non-US English language
Issue When using English (United Kingdom), English (Australia), or English (Canada) as the default language in Liferay DXP page, the default page displays a placeholder message instead of the expected "Welcome to...
Inconsistent Image/Document Loading after upgrading to DXP 7.4U80+ due to S3 connection timeout
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)
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...
Incorrect Price on Catalog Page and PDP(Product Detail Page)
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...
How to Set the Limit of Pages to Preview Documents in SaaS enviroments
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...
Hindi Month Names Are Truncated in Search Results
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...
Timeout 504 Error During Multiple File Downloads via POST Method
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...
SAML Certificate Deleted After Restarting Liferay DXP on Kubernetes
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...
Documents and Media files are not loading after setting up a 2nd cluster node
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...
User Redirected to Guest Site Login After Clicking Form Submission Link in Email Notification
Issue Clicking the form submission link in an email notification redirects a user to the login form on the Guest site instead of the site where the form was submitted. Navigate to Control Panel > System Settings >...
Liferay.on("allPortletsReady") getting fired before all portlets are ready
Issue Liferay.on("allPortletsReady") getting fired before all portlets are ready Steps to reproduce: Start the server. Create a form with multiple text fields, single selection radio button set with multiple...
Pagination Numbers Displayed in Hindi Numerals When Language is Switched to Hindi
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
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...
Radio Buttons in Forms cannot be navigated by keyboard
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...
Are Document Previews in Liferay Compatible with '.potx' File Extensions?
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....
Special characters like apostrophe (') is displayed as its ASCII value in the account address field
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...
After upgrading to DXP 7.4 u92 I receive an unable to locate transaction executor error on server startup
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...
Make certain pages accessible to specific IPs only
Issue How to make certain pages to be accessible only via specific IPs. Environment Liferay DXP [all versions] Resolution In order to allow certain pages to be accessible via specific IPs, users can perform...
Unwanted spaces appearing after HTML tags in translated text
Issue When using HTML tags like <strong>, <b>, <h1>, <span>, and <i> within internationalized text in the Language Override functionality, an unnecessary space is generated after the closing tag when the text is rendered...
Receiving resource not found error when creating commerce product through headless API
Issue When creating a product using headless API. After creating it, the product status shows 'Approved'; however, when searching for the product or clicking the product to open it, that shows the resource not...
How to set up Search Blueprints to be used with Search headless API
Issue You do not find a suitable headless API or is not still developed by Liferay so you would like to create your own search blueprint and invoke it easily from Search API. For example, retrieve draft...
JournalContentSearchLocalServiceUtil.getLayoutIds returns an empty list
Issue When trying to retrieve the pages where a web content article is displayed using its articleId, an empty list is returned. After instantiating a web content in a Content Viewer, the following...
Null Values for PortalInetSocketAddress and PortalProtocol for Cluster Nodes
Issue When running a Groovy script to check cluster formation, the output shows "null" for PortalInetSocketAddress and PortalProtocol for some nodes. Environment DXP 7.4 Quarterly Releases Resolution...
ERR_CONTENT_DECODING_FAILED
Issue When the user is accessing their DMS application, sometimes they encounter the below error in the browser console: Error : Failed to load resource: net::ERR_CONTENT_DECODING_FAILED....
What 'type' parameter should I provide to the addUser() function when creating a User through API?
Issue I would like to create a user via UserLocalServiceUtil.addUser() One of the parameters required is 'int type'. What value should I provide to this type parameter? Environment DXP 7.4 Quarterly Releases...
URL redirection between sites in Liferay DXP 7.4
Issue After migrating from Liferay DXP 7.3 to DXP 7.4, URL redirection rules defined in rewriteurl.xml (no longer supported in 7.4) and through .config files stopped working. Liferay’s built-in redirection...
Groovy Scripts not working on Partner Portal
Issue While filling out the upgrade request form on Partner Portal, the groovy scripts 'ee_6_2-all.groovy' and 'PrintDatabaseInfo_DXP_Modified.groovy' are not working. Environment Liferay Portal 6.2...
Database Upgrade from Liferay 6.2 to DXP 2024.Q4 Fails on Oracle 19
Issue When upgrading from Liferay 6.2 to DXP 2024.Q4 quarterly release using the `db_upgrade_client.sh` script, the process fails with the following error: Type change is not allowed when altering column name. Column...