Site Search - Liferay Learn

How to Optimize Language Selection for SEO

Issue The language selector in Liferay DXP uses the /c/portal/update_language URL, which calls the UpdateLanguageAction.java action. This action sets the selected language and redirects the user to the...

Email Sender Configuration is not being saved

legacy Troubleshooting

Issue When modifying the Email Sender Name in our PROD environment by following these steps: Control Panel > Instance Settings > Email Access "Email Sender" in the left menu Set "XYZ" in the "Name" field > Save the...

Incorrect Pagination Behavior in the SearchResultsPortlet

legacy Troubleshooting

Issue I have an issue with the search results portlet pagination. When searching for an item by selecting a page after page 20, the first page results are shown instead of the selected page. Steps to reproduce: Set up...

"Information Templates" page is blank

legacy Troubleshooting

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

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

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

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

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

The drop-down is not working when clicking anywhere apart from the arrow

legacy Troubleshooting

Issue The category filter fragment only expands or collapses the category list when clicking the dropdown arrow. Clicking the category name itself does not trigger this action. Steps to reproduce: 1. Navigate to...

I received the following error in the log: Feature flag LPD-10588 is not available for company 0

legacy Troubleshooting

Issue After upgrading to 2025.q1.6-lts, I received the following error in the log: Feature flag LPD-10588 is not available for company 0 Environment Liferay Quarterly Release 2025.q1.6-lts Resolution The case has been...

Object entry reviewer to have access only to currently reviewed object, not to all entries

legacy Troubleshooting

Issue Issue description: I have enabled a review workflow for an object and noticed that if I want the reviewer to be able to edit the submitted object entry during the review task, I need to add the "Access in Control...

Hidden Heading () and Incorrect role="main" Usage in Liferay DXP Theme

legacy Troubleshooting

Issue An unnecessary hidden heading, <h1 class="sr-only">Navigation</h1>, is present in the page source code. Although hidden visually, it is still picked up by screen readers, which can confuse users...

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

Filtering Analytics Cloud Individual User Activity by Date Range via API

legacy Troubleshooting

Issue There is a requirement to filter Analytics Cloud individual user activity data by date range using the API. individual user activity can be extracted withcurl -i -L -H "Authorization: Bearer {token}" -L...

Why is the Back Button not working?

legacy Troubleshooting

Issue Users have reported that the back button does not function as expected in certain areas of Liferay. Environment Liferay 7.4 Resolution Kindly navigate to Control Panel → Instance Settings → Content...

Duplicate Web Content Articles are Published if 'Publish' button is clicked several times in succession

legacy Troubleshooting

Issue When publishing Web Content Articles, I noticed several duplicate Web Content Articles are created when the "Publish" button is clicked multiple times in a row Each Web Content Article would have identical...

Running script to import Result Rankings data fails

legacy Troubleshooting

Issue When attempting to run the script from step 2 on Importing the Search Tuning Indexes in 7.4 to import the Result Rankings data, execution fails with the following errors: startup failed: Script1.groovy: 3: unable to...

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

Unable to Save Object Definition After Deleting a Fragment

legacy Troubleshooting

Issue Unable to save an Object definition after deleting a fragment from a Content Page. Reproducing Steps: 1. Create an object definition with one field. 2. Add an object entry for this object definition....

Custom Pagination Override Not Working on WebLogic

legacy Troubleshooting

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

Unable to Create Module for Liferay DXP 2025.Q1.0+ using Liferay Developer Studio 3.10.2

legacy Troubleshooting

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

Web Content Not Visible in Related Asset Window

legacy Troubleshooting

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

What is causing large temp files to be created?

legacy Troubleshooting

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

Builds not deploying to dev environment

legacy Troubleshooting

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

Objects API PUT Calls Partially Update Resources Instead of Replacing Them

legacy Troubleshooting

Issue When using the Objects headless API, PUT commands for Objects are only overwriting fields included in the API call, rather than replacing the elements entirely. PUT calls should update every object...

Receiving ClassNotFoundException:JspTagHandlerPool in traces

legacy Troubleshooting

Issue When starting the server, receiving the ClassNotFoundException:JspTagHandlerPool in the gowroot traces: Steps to reproduce: 1. Start the server by giving this command: ./catalina.sh glowroot run. 2. Now...

Getting out of memory error and receiving DelayedCachedOutputStreamCleaner

legacy Troubleshooting

Issue Receiving of out-of-memory error and the below thread in the thread dumps: DelayedCachedOutputStreamCleaner" #3359 java.lang.Thread.State: TIMED_WAITING at java.lang.Object.wait0(Native Method) - waiting on...

Object moves folders when creating second object

legacy Troubleshooting

Issue When creating two objects through Model Builder, creating a second object causes the first object to be moved to a different folder. Environment Quarterly Release Resolution This issue was fixed in 2025.Q1.12 with...

Advanced Tab in the Monitoring section on the Cloud Console is not showing up

legacy Troubleshooting

Issue The Advanced Tab does not appear in the Monitoring section on the Cloud Console Environment Liferay Cloud - PaaS Resolution...

How can I implement the Google Site Verification meta tag in Liferay?

legacy Troubleshooting

Issue I want to implement the Google Site Verification via meta tag in Liferay, but after adding the Google-provided meta tag data to my site through Custom Meta Tags, the verification is still failing. ...

CAPTCHA is not refreshing in Sign-In popup on Sign-In page

legacy Troubleshooting

Issue CAPTCHA is not refreshing in the sign-in pop-up page. If the user is already on the sign-in page and opens the sign-in form from the pop-up, the CAPTCHA does not refresh properly in the pop-up. Steps to...

One cluster node doesn't start up completely after OS patching

legacy Troubleshooting

Issue I am currently running a Liferay cluster. I patched my OS then rebooted each server separately. One more more nodes came back online correctly, but at least one node isn't starting up completely, and I see...

Workflow "Metrics" Data Not Visible After Upgrading Liferay

legacy Troubleshooting

Issue After upgrading Liferay from 2024.Q2.7 to 2025.Q1.4-lts, navigated to Applications Menu > Applications > Workflow > Metrics, and noticed that the data is not being displayed. Steps to reproduce: Start Liferay...

Feature Flags are not enabled by Default

legacy Troubleshooting

Issue I have an issue with the feature flags: feature.flag.LPD-11131=true and feature.flag.LPD-35013=true I set both features in the portal-ext.properties file in 2025.q1.6-lts. However, after started the instance the...

Exceptions in the log when the Glowroot page times out

legacy Troubleshooting

Issue I see a lot of exceptions in the Glowroot logfile. It is caused by administrators accessing the glowroot page and leaving it open in a tab. Then the session times out and since the frontend tries to update the...

Reindexing Errors and Warnings After Upgrade

legacy Troubleshooting

Issue After upgrading Liferay, reindexing throws errors and warnings in the logs. Liferay starts up successfully, and the database upgrade finished without errors. Errors: 2025-04-15 11:58:36.632 ERROR...

Unable to migrate content from Dynamic Data Lists to Objects using the Data Migration Center

legacy Troubleshooting

Issue Unable to migrate content and data from Dynamic Data Lists through the Data Migration Center due to issues found during the process. Environment DXP 2023.Q4+ Portal GA102+ Resolution The...

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

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