Site Search - Liferay Learn

Unable to define the searchable option with new objects fields

Issue Unable to configure the searchable options of new fields added to an object after it has been published. Steps to reproduce: Create an object: 'Pets' Add a new field: 'petName' (Text, indexed as text) Publish...

Unable to Publish Object Definition Relationships after Importing

legacy Troubleshooting

Issue The user is not able to publish Object Definition relationships after importing them Steps to reproduce: 1) Navigate to the Applications Menu -> Control Panel -> Objects 2) Import one Object Definition with a...

Not possible to add Custom Entry on page

legacy Troubleshooting

Issue Mapping with Custom Objects is not working on Pages Steps to Reproduce: 1) Menu > Control Panel > Objects 2) Create a Custom Object 3) Navigate to Custom Object and click on the Fields tab 4) Add a Custom...

How can I include my JSP in a Liferay Blade Servlet?

legacy Troubleshooting

Issue I'd like to include a JSP in the doGet method of my Servlet plugin. The following gives NullPointerException: this.getServletContext().getRequestDispatcher("index.jsp").include(httpServletRequest,...

Form Field template not available in Liferay Maven Workspace

legacy

, knowledgeArticleType: reference, legacy: true, name: Form Field template not available in Liferay Maven Workspace, showDisclaimerMessage: true, sourceTeam: Support, ticketNumber: 99362, title: ...

Blade does not build war-core-ext modules for Liferay DXP 7.3 when using Maven

legacy Troubleshooting

, knowledgeArticleType: troubleshooting, legacy: true, name: Blade does not build war-core-ext modules for Liferay DXP 7.3 when using Maven, showDisclaimerMessage: true, sourceTeam: Support, ticketNumber: 45325,...

How do I upgrade a 7.x Maven theme to be a Maven theme for a next 7.x version?

legacy

, knowledgeArticleType: howTo, legacy: true, name: How do I upgrade a 7.x Maven theme to be a Maven theme for a next 7.x version?, showDisclaimerMessage: true, sourceTeam: Support, ticketNumber: 18829, title:...

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

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

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

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

Default Language not being applied to not translated content

legacy Troubleshooting

Issue There is an undesirable behavior present when creating an object and utilizing the language translation. The content is empty instead of showcasing the content translated. Steps to reproduce: Instance Settings...

How to create a Clay Dropdown Menu with Button in Liferay 2024.Q2

legacy How To

Issue Cannot create a dropdown menu with checkboxes and an Apply button that is used to save the selection in the menu using Clay UI. Environment DXP 7.4 2024.Q2 Resolution You can add button functionality to modul by...

When building Liferay DXP, SAML modules are not included in .BOM files

legacy How To

Issue When building Liferay DXP, the .BOM dependencies file does not include SAML modules. Environment DXP 2023.Q4.0 Resolution It is not an issue and is confirmed to be intended as it is. DXP...

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

When using Liferay Objects, the pages are inaccessible when viewed from the ellipses menu

legacy Troubleshooting

Issue When using Liferay Obejcts with enough Objects to where the ellipses menu is necessary (7 pages), the pages shown when clicking on the ellipses are inaccessible. The pages are only accessible if they are...

Is it possible to use a hotfix when building my custom code?

legacy How To

Issue I have been provided with a hotfix, and I want to compile my custom code using that hotfix from my Liferay Workspace. Environment Any Liferay DXP version Liferay Developer Tools Resolution There is not an easy...

How to programmatically add a form entry with API?

legacy How To

Issue I am currently working with a Liferay form. I am attempting to submit a new record to this form using the /ddm.ddmforminstancerecord/add-form-instance-record API via JSON Web Services (JSONWS). This API requires a...

Facing issues in setting 'liferay.workspace.product' property for Liferay Workspace

legacy Troubleshooting

Issue Upgrading the portal from Liferay DXP 7.4 Update 67 to Liferay DXP Quarterly Release 2024.Q1.9 and trying to set 'liferay.workspace.product = dxp-2024.q1.9' in the gradle.properties however, it is not...

Upgrade Fails: Error after upgrading using the Database Upgrade Tool (MS SQL Server)

legacy Troubleshooting

Issue After running `db_upgrade_client.bat` my upgrade failed with no explanation in the logs. Upgrade failed, when it was attempted again it was successful but Liferay won't start After upgrading, Liferay...

Liferay 7.3 Update36 not available on CDN

legacy

Issue We are planning to upgrade product to version dxp-7.3-u36, but noticed that it's currently unavailable on CDN product_info.json Environment DXP 7.3 Resolution Since the introduction of the Quarterly Releases, it...

Error: Could not find or load main class com.liferay.css.builder.CSSBuilder

legacy Troubleshooting

Issue After switching to JDK11 I'm unable to build my project. Build failed with an exception that lists a path to my java version. Error: Could not find or load main class...

Objects - multiple items can be saved but only one item is displayed in the administration view

legacy

Issue When I try to create an object with an upload field, and save a new item multiple times, the object is only displayed once in the administration view. The uploaded item is not cleared from the field either. Is...

Dynamic Picklist in Liferay Forms using Objects

legacy Troubleshooting

Issue We have created a Liferay form with Object and used the concept of dynamic picklist (data provider + picklist). However, we're facing issues with saving the data (selected from the picklist) upon form...

GUEST users have no access to custom objects API

legacy Troubleshooting

Issue Templates which make use of the objects API are not working correctly for guest users. Environment Liferay 7.4 and Quarterly Releases. Resolution You need to add the VIEW permission for your custom...

How to send a confirmation email to non-authenticated users about Form submissions based on Objects?

legacy How To

Issue I would like to send a confirmation email to the non-authenticated user who just submitted a Form based on an Object. Environment Quarterly Releases: 2023.Q3, 2023.Q4, 2024.Q1 Resolution Create an Object with...

Traces from custom module stop printing after redeploy

legacy Troubleshooting

Issue A custom module prints traces the first time it's deployed but not if redeployed. After restarting Liferay it works again. Environment Quarterly Release 2023.Q3, 2023.Q4, 2024.Q1 Liferay DXP 7.4 Resolution...

Form is not showed to guest (unauthenticated) users

legacy Troubleshooting

Issue We have a form, based on a custom object, in a page. This form is not showed when user is not logged in. Whereas the form is showed when user is logged in. Environment 2024.Q1 Resolution Check if the 'guest'...

NoSuchFileException: null/override error when starting Liferay or executing the Upgrade Tool

legacy Troubleshooting

Issue Right after starting Liferay or executing the Upgrade Tool, there a NoSuchFileException: null/override error in the log. 2024-04-01 15:44:08.392 ERROR [main][DBUpgrader:110] null java.lang.RuntimeException:...

EXT module override is not being applied in 2023.Q3.3+ from ${liferay.home}/osgi/marketplace/override

legacy How To

Issue Adding an EXT module override in ${liferay.home}/osgi/marketplace/override no longer functions. Environment Liferay DXP Quarterly Release 2023.Q3.3 and later releases Resolution To workaround this behavior for the...

liferay-module-config-generator as a dependency

legacy

Issue As a developer, should I add liferay-module-config-generator in the block dependencies or in the block devDependencies? Environment Liferay DXP 7.1 Resolution This module is thought to be used in the block...

Unable to build the module: Could not find com.liferay.portal:release.dxp.api errors

legacy Troubleshooting

Issue Sometimes users face the following error while building their modules: Task modules: test-search-results-limit:compileJava FAILED FAILURE: Build failed with an exception. what went wrong: Execution failed for...

Unable to add custom object using collection display

legacy Troubleshooting

Issue Steps to reproduce: 1. Go to Control Panel > Object 2. Create a new Object O1 3. Click on Object > Account98 4. Go to tab relationship 5. Create a relationship "O1 rel" type "One to many" with custom object...

View Display Page for Objects is not working for guest users

legacy Troubleshooting

Issue When creating a Display Page Template to display entries of an object, even when setting the viewing permission to "guest," attempting to access the page template results in a 404 page. Environment Liferay...

Could not install Gradle distribution

legacy Troubleshooting

Issue While importing workspace from one system to another through a remote desktop connection, the below error has been encountered: Could not install Gradle distribution from...

'ConfigurationProviderUtil cannot be resolved' after upgrading

legacy Troubleshooting

Issue We've begun updating to the dxp:2023.q4.4 version and encountered the following error while building the code on the 2023.Q4.4 baseline:...

Object Entries do not appear in Search Results

legacy Troubleshooting

Issue Object entries are not visible in Search results Environment Liferay DXP 7.4 Resolution When you create an Object Definition, you get to choose whether its scope is Company or Site (you cannot change it once...

ObjectFieldNameException$MustNotBeDuplicate when updating Object Definition

legacy Troubleshooting

Issue When trying to update an object definition from one environment (eg. dev) to the other (eg. uat), the process fails with the following error:...

Liferay Artifact missing from Maven Repository

legacy Troubleshooting

Liferay Support does not recommend or endorse specific third-party products over others. The information provided about products not created by Liferay is for reference purposes only, and any implementation of these...

Service Builder Tool 1.0.478 gives "Unable to parse package path from..." Error in Windows

legacy Troubleshooting

Issue After cloning https://github.com/liferay/liferay-blade-samples.git, Windows OS users may run into the following error: Task :apps:service-builder:basic:basic-service:buildService FAILED Building Foo Unable to...