Site Search - Liferay Learn

Integrating Service Builder Applications with Objects

Integrating Service Builder Applications with Objects You can integrate existing Service Builder applications with the Objects framework. Once integrated, your custom entities become unmodifiable...

Workflow Definition Link API Basics

Official Documentation

Workflow Definition Link API Basics Liferay DXP 2025.Q1+/Portal GA132+ You can manage workflow definition links from the Liferay UI or using Liferay's REST APIs. In Liferay, the Control Panel →...

Upgrading to Jakarta

Official Documentation

Upgrading to Jakarta Liferay DXP 2025.Q3+ Liferay stepped into the future of enterprise Java when it moved to Jakarta EE starting with the DXP 2025 Q3 and the 2026 Q1 Portal releases. This frees...

Using Object Inheritance

Official Documentation

Using Object Inheritance [Release Feature (LPD-34594)](../../../../security-and-administration/administration/configuring-liferay/feature-flags.md#release-feature-flags) Liferay DXP...

Using a CAPTCHA Client Extension

Official Documentation

Using a CAPTCHA Client Extension Liferay DXP 2025.Q3+ CAPTCHA challenges are used on websites to verify a human user is accessing it, and not a bot or malicious code attacking the site. Liferay...

CAPTCHA YAML Configuration Reference

Official Documentation

CAPTCHA YAML Configuration Reference You can define a CAPTCHA client extension with a client-extension.yaml file. Usage Details This client-extnesion.yaml file defines a CAPTCHA client extension: ...

Configuring service.properties

Official Documentation

Configuring service.properties Service Builder generates a service.properties file in your *-service module's src/main/resources folder. Liferay uses this file's properties to alter your service's...

Connecting Service Builder to an External Database

Official Documentation

Connecting Service Builder to an External Database Service builder creates the necessary tables for the service in the lportal database with all other data used by Liferay. If you want to store the...

Liferay Workspace Configuration Reference

Official Documentation

Liferay Workspace Configuration Reference Liferay Workspace has many options you can set. Here's a handy command and properties reference. Running Liferay DXP locally my-project $ blade gw...

Managing Object Entries with Data Sets

Official Documentation

Managing Object Entries with Data Sets Data sets offer a flexible way to display object entries. When your advanced use case outgrows collections, data sets fill the gap. For example, Collections...

Scheduling and Subscription

Official Documentation

Scheduling and Subscription [Release Feature](../../../security-and-administration/administration/configuring-liferay/feature-flags.md#release-feature-flags) (LPD-17564) Liferay DXP...

Assignee Fields

Official Documentation

Assignee Fields Liferay DXP 2025.Q4+/Portal 2026.Q1+ Assignee fields are for selecting existing users or roles in the object entry. Assigned users can edit the entry with no manual permission...

Developing a PortletMVC4Spring Portlet

Official Documentation

Developing a PortletMVC4Spring Portlet PortletMVC4Spring compliments the Spring Web framework and MVC design pattern by providing annotations that map portlet requests to Controller classes and...

Migrating to PortletMVC4Spring and Jakarta

Official Documentation

Migrating to PortletMVC4Spring and Jakarta There are two possible migrations: You've already used PortletMVC4Spring, and you want to migrate your application to Jakarta. You want to migrate a...

Using Object Entry Manager

Official Documentation

Using Object Entry Manager Reading and writing object entry data programmatically is best accomplished with the auto-generated headless APIs. However, when using traditional OSGi extension points...

Setting Default Field Values

Official Documentation

Setting Default Field Values Liferay DXP 2026.Q1+ You can use default field values to reduce manual entry errors and ensure that your object data remains consistent across all creation methods....

AI Tools in Workspace

Official Documentation

AI Tools in Workspace You can use the latest AI-based tools to jump start your projects in Liferay Workspace. Whether you prefer to code with Claude, Copilot, Cursor, Gemini, Windsurf, or any other...

Data Sets are not working after upgrading to 2025.q1.4-lts where the feature is released

Troubleshooting

Issue I upgraded from 2024.q4.7 to 2025.q1.4-lts. After the upgrade, we encountered issues with Data Sets. In 2024.q4.7 I was using datasets as beta but as in 2025.q1.4 its released. I have enabled Root Objects and Datasets both release flags but the data Sets are not available on the...

Liferay IDE: Resolving 'Unable to make field private' errors with JDK 21

Troubleshooting

Issue I'm encountering java.lang.reflect.InaccessibleObjectException: Unable to make field private ... accessible errors when starting Liferay from the Liferay IDE plugin within the Eclipse IDE with JDK 21. Environment 2024.Q2.12 Resolution The error occurs because the Liferay IDE's...

Client Extension Build Fails Due to Unresolved Dependency

legacy Troubleshooting

Issue When building a Client Extension of type jsImportMapsEntry, the build fails if the Client Extension depends on another Client Extension, because the build cannot resolve the dependency. Environment Liferay DXP Quarterly Release Resolution To resolve this issue, explicitly define...

Limit the languages displayed in the translation selector for object fields

Issue We want to limit the languages displayed in the translation selector for object fields to only those defined in the site, similar to how it works for Journal Articles. Currently, the selector shows all languages available in the environment. Environment DXP 7.4 Resolution Limit the...

Unable to Create Liferay Module Project Fragments and Start DXP 2025.Q1.0 Quarterly Release (LTS) in Liferay Developer Studio 3.10.2

Troubleshooting

Issue In Liferay Developer Studio (version 3.10.2), when navigating to File > New > Liferay Module Project Fragment, nothing happens. The popup window for creating the fragment does not appear. Additionally, not able to start DXP 2025.Q1.0 Quarterly Release (LTS) and get the following...

How to allow unauthenticated (guest user) requests for GraphQL

Troubleshooting

Issue I implemented ReactJS Widget that relies on GraphQL requests for custom object values, with a widget exposing object entries to the public. However, unauthenticated GrapQL requests are disabled by default and guest users cannot see the widget content. Is there way to enable GraphQL...

Updating Parent Object Fields from Child Object Actions

legacy How To

Issue How to update a field's value in the parent object when a new child instance is created using object actions of the child object. Environment Liferay DXP 7.4+ Resolution Use a Groovy script Action triggered by onAfterAdd or onAfterUpdate on the child object to update the parent...

Client Extensions Not Visible After Deployment in SaaS

legacy Troubleshooting

Issue Client extensions are successfully deployed to SaaS, the service registers as ready, and are listed in the Client Extensions Control Panel app, but they are not visible in the Widget UI when trying to add them to a page. Environment Liferay DXP SaaS Liferay Client Extensions...

Staging Object Entries

legacy

Issue I would like to enable Staging for my Object Entries Environment Quarterly Releases Resolution This feature is not yet available in Liferay, however, it is already on the roadmap You may view the development's current status at LPD-30525 , knowledgeArticleType: reference, legacy:...

Defining Permissions for Object Entries

legacy

Issue The creator/owner of an object entry (or any other data type) has full permissions to manage that entry (update, delete, view). I would like to give Object Admins the possibility to define/restrict permissions for Object entries, even if they are not the author of the entry....

Using Required for system configurations.

legacy Troubleshooting

Issue We would like to add required = true configuration to our system configuration. Upon requesting the data through a groovy script the string returns empty when required = true is set. Environment DXP 7.4+ Resolution Sadly this is currently a limitation of...

If Form entries are saved into an Object, email notification about Form submission is not sent

legacy Troubleshooting

Issue We have created an Object and a Form. We save Form entries into the Object. When a Guest user submits the form, the notification is not sent out. We are getting the following error in the logs: ERROR [http-nio-8080-exec-1254][DDMFormEmailNotificationSender:90] Unable to send form...

Form Container does not display relationship field for parent object

legacy Troubleshooting

Issue I have an object A with a one-to-many relationship to object B. When I add a Form Container to a page and map it to object A, I cannot select the related object B entries. Environment Liferay DXP 7.4+ Resolution Liferay Forms does not currently support mapping object relationships...

How to create Charts in Quarterly Versions

legacy How To

Issue The Chart Tag Library was removed in 2023.Q4 with no direct replacement. I would like to know how to create charts in a Liferay version higher than 2023.Q4. Environment 2023.Q4+ Resolution On GitHub, you can find an example of how our developers create charts in e.g. Content...

Localizing Object Definitions.

legacy Troubleshooting

Issue We do not find where is the feature to get objects localization. Based on following documentation https://learn.liferay.com/w/dxp/liferay-development/objects/creating-and-managing-objects/localizing-object-definitions-and-entries, this feature should be available since 2023.Q3...

Is possible to sort Object entries in a Collection Display Fragment?

legacy How To

Issue I'm using a Collection Display fragment to show objects. I need to apply some order to the list. Is this possible? Environment Liferay DXP 2024.Q4 Resolution Currently, the only way to sort object entries (with Collection Display) would be by creating a Dynamic Collection and use...

Data Migration Center: Unable to Import CSV file

legacy Troubleshooting

Issue The issue only occurs when the field is being translated, using objects alone does not cause it. Steps to reproduce 1. Navigate to the Applications Menu and click on Data Migration Center. 2. In that, click New and then export file option [create one object first with 2 fields:...

Getting invalid checksum error when building the Liferay Workspace

legacy Troubleshooting

Issue Facing an error when attempting to initialize a Liferay DXP bundle in the user's Liferay workspace. Steps to reproduce: 1. Create a Liferay workspace project. 2. Set the following in gradle.properties: liferay.workspace.bundle.dist.include.metadata = true...

Unable to Run Developer Studio 3.9.8 with JDK 17

legacy Troubleshooting

Issue When attempting to run Liferay Developer Studio 3.9.8 on JDK 17, there's no option available to configure JDK 17 when navigating to Window -> Preferences -> Java -> Compiler -> Compiler compliance level. Environment Liferay Developer Studio 3.9.8 Quarterly Release Resolution...

Spring Boot Client Extension cannot be deployed successfully

legacy Troubleshooting

Issue After deploying a Spring Boot client extension, it is loading indefinitely with the following message: CustomSpringBootService is gearing up. The service should be ready to receive requests soon. The following messages are displayed in the service's logs: [INFO tini (1)] Spawned...

How to define the order in which multiple object actions (defined for the same trigger) will be executed?

legacy

Issue I was wondering is there a possibility to order/prioritize object actions that use the same trigger? For example, I have two object action, action1 and action2, and they are both triggered by On after add. I need to run the action1 before I run the action2. Can I do that somehow,...

Unable to get product info error showing in console

legacy Troubleshooting

Issue When building projects, users are getting the below error in the console: FAILURE: Build failed with an exception. * Where: Settings file 'C:\Users\ABC\Downloads\Dev\liferay\example\settings.gradle' line: 16 * What went wrong: A problem occurred evaluating settings 'example'. >...

HTML elements disappear when creating new Object entries

legacy How To

Issue An embedded video (iframe) and other HTML elements within a Rich Text field of an Object are not persisting after saving a new entry. Environment Liferay DXP 2024.Q2 Resolution This is an expected behavior due to the AntiSamy sanitizer. This tool will remove all iFrame and...

How to overcome BOMs pointing to wrong JARs?

legacy Troubleshooting

Issue When compiling our custom code, we encounter issues where our OSGi modules fail to start due to unresolved references to the Liferay packages. For instance, the following error is thrown: org.osgi.framework.BundleException: Could not resolve module: my.custom.portlet [1111]_...

I cannot use the PUT method of the Object API's Batch endpoint with External Reference Codes (ERC)

legacy How To

Issue It is not possible to mass update a custom object's entries if: using the PUT method of the object's batch API endpoint and the External Reference Code (ERC) is given instead of the object entry's ID. The operation fails with NullPointerException: Cannot invoke...

Outdated Patching Tool found in 2024.Q3.6-.9 Docker Images

legacy Troubleshooting

Issue A different patching tool version was found in 2024.Q3.6-.9 Docker Images, but not in bundles downloaded from the Help Center. Environment 2024.Q3.6-.9 Resolution The correct version of the patching tool 4.0.5 has been added to 2024.Q3.6-.10. Additional Information Upgrading to a...

Upload attachments to custom objects Headless API

legacy Troubleshooting

Issue Create a custom object having an attachment field. Error 400 when trying to create an object using this field. { "status": "BAD_REQUEST", "title": "The value is invalid for object field \"attachmentField\"" } Environment 2024.Q2+ Resolution When using 2024.Q2 and 2024.Q3, the...

"Cannot use import statement outside a module" JS error with a custom form field type

legacy Troubleshooting

Issue After creating a new form field type (e.g. blade create -t form-field ...) or upgrading a custom form field type to a newer version, a JavaScript error is displayed in the console when dragging the field in the Form editor. Uncaught SyntaxError: Cannot use import statement outside...

How to send Form submission notification for Guest user

legacy How To

Issue Form submission notifications usually are meant to be sent to already created users. Is there a way to send form submission notifications for a Guest user? Environment Liferay DXP 7.4+ Resolution Yes, there is. It's not a direct approach, and several steps must be made in order to...

"The server could not start in 900 seconds" error occurs when starting server in Liferay Developer Studio

legacy Troubleshooting

Issue Liferay server crashes when running under Liferay Developer Studio for 15 minutes, reporting the following error dialog: The server could not start in 900 seconds. Environment Liferay 2024.Q2 Resolution As of now, this does not have an existing fix. The workaround for this, is...

Beta Feature 'Walkthrough' Documentation Unknown

legacy

Issue There is a beta feature called 'Walkthrough' available to enable under Configuration > Site Settings > Walkthrough, but I cannot find any documentation for it. Environment DXP 7.4 Quarterly Release Resolution Given that this is a beta feature at its current stage there is very...

Which Liferay version should be used in gradle.properties for the 2024.Q1.1 version?

legacy How To

Issue Which Liferay version should be used in gradle.properties for DXP version 2024.Q1.1 Environment Liferay DXP Resolution 1. Looking at the release JSON here, the property should be liferay.workspace.product=dxp-2024.q1.1 2. Similarly, the additional properties should be:...

Is it possible to enforce that you cannot create/save a parent object until you have connected to it at least one child object?

legacy

Issue steps : - Create Object called "news" - Create object called "News Attachments" the requirement : I cannot add new news without adding attachments , I need to prevent the user to add a new news without attachments . Environment QR Resolution this is not possible in the...

Headless API is still returning properties from items in the recycle bin

legacy

Issue After we delete an image that was linked to a document through a structure and it's in the recycle bin, the Headless API is still returning all of its image details in the response. Environment 7.4 Resolution This is the expected behavior. When an image is first moved to the...

Custom portlet renders the language resources as the key

legacy Troubleshooting

Issue Custom portlet renders the language resources as the key. What should we change in our code to render the language correctly? Environment Liferay DXP 2024.Q2 Quarterly Release Resolution There’s a workaround based on Declare the Override in the Bnd File, which is adding the...

Deployment dependencies that require internet connectivity (On-premise)

legacy

Issue What are the necessary dependencies that require internet connectivity during the build and runtime of a project? Environment Liferay DXP 7.4 Resolution Technically, all dependencies are downloaded over the internet, besides the local inter-project dependencies. As a result, there...

Issue while adding, publishing and deleting the objects

legacy Troubleshooting

Issue Unable to add, publish, and delete the objects in Liferay. Below are the observed errors: 1. Uncaught (in promise) SyntaxError: Unexpected token '<', "<HTML><HEA"... is not valid JSON. 2. Failed to load resource: the server responded with a status of 501 () 3. Unsupported Request...

When using blade under Windows, I get 'Failed to find Java VM' error

legacy Troubleshooting

Issue Using any blade command, as blade version shows 'Failed to find Java VM' error Environment Microsoft Windows. Resolution This behavior can be related to updating the JVM after a blade installation. In this case, blade configuration points to previous JVM path. In consequence, blade...

Screen name should not be required when Autogenerate User Screen Names is enabled

legacy How To

Issue When enabling Autogenerate User Screen Names, the Object Action still mandates a Screen Name field, which is an inconsistency. The aforementioned behavior can be reproduced by doing the following steps: Go to Instance Settings → Users → Fields Enable Autogenerate User Screen Names...

Search results are showing unexpected visual changes when rendering Object items

legacy Troubleshooting

Issue When searching for Objects on a search page, there are some unexpected visual changes in the result. Environment Quarterly Releases Resolution Please verify that whether there are any HTML in the description of the Object that may be contributing to this behavior. If there is,...

Language Keys are processed as Literal Text in custom MVC Portlets

legacy Troubleshooting

Issue When creating a MVC Portlet that leverages language keys, language key output is presenting as the literal text, rather than the key value For example: Language key in view.jsp: <b><liferay-ui:message key="languagekeys.caption"/></b> Language Key Value in language.properties:...

Form View in Workflow

legacy

Issue When an admin receives the multi-step form created by Objects to review, the form data is visible on a single page instead of page by page. Steps to reproduce: 1. Create a multistep form with the help of Liferay objects (Building Multi-Step Forms With Liferay DXP Objects) 2....

module java.base does not "opens java.lang" error in buildService using Java 21

legacy Troubleshooting

Issue The following exception is thrown when trying to build a service with Service Builder: Failed to initialize ClearThreadLocalUtil java.lang.ExceptionInInitializerError at com.liferay.petra.reflect.ReflectionUtil.<clinit>(ReflectionUtil.java:160) at...

Search Results