Site Search - Liferay Learn

Note: please note that Liferay has renamed its Liferay Experience Could offerings to Liferay SaaS (formerly LXC) and Liferay PaaS (formerly LXC-SM). Issue How to disable robots in some pages and how to disallow the robots indexers to reach an environment. Environment DXP 7.0 DXP 7.1 DXP...

Is it possible to set up multiple git branch/Liferay PaaS environment pairs for automatic deployment?

legacy

Note: please note that Liferay has renamed its Liferay Experience Could offerings to Liferay SaaS (formerly LXC) and Liferay PaaS (formerly LXC-SM). Issue In this Liferay PaaS Documentation, I see that it's possible to automatically deploy successful builds from a specific git branch to...

How to handle HTTP status errors with Liferay PaaS

legacy How To

Note: please note that Liferay has renamed its Liferay Experience Could offerings to Liferay SaaS (formerly LXC) and Liferay PaaS (formerly LXC-SM). Issue How to configure the redirect of each HTTP status outside Liferay with Nginx. Inside Liferay you are able to manage some related...

When a Friendly URL is created the redirection is temporal (302) when it should be permanent (301)

legacy

Note: please note that Liferay has renamed its Liferay Experience Could offerings to Liferay SaaS (formerly LXC) and Liferay PaaS (formerly LXC-SM). Issue When a Friendly URL is created the redirection is temporal (302) when it should be permanent (301) Environment Liferay SaaS with DXP...

Enabling Antivirus Scanning for Uploaded Files does not work

legacy

Note: please note that Liferay has renamed its Liferay Experience Could offerings to Liferay SaaS (formerly LXC) and Liferay PaaS (formerly LXC-SM). Issue We follow the steps explained in this article Enabling Antivirus Scanning for Uploaded Files. Then we uploaded a file with a virus,...

Jenkins unable to update commit status to GitLab

legacy Troubleshooting

Note: please note that Liferay has renamed its Liferay Experience Could offerings to Liferay SaaS (formerly LXC) and Liferay PaaS (formerly LXC-SM). Issue Builds using gitlab-api fail during the last steps of the build, when Jenkins tries to update the commit status to GitLab using the...

Getting Portal version and Patch level

legacy How To

Note: please note that Liferay has renamed its Liferay Experience Could offerings to Liferay SaaS (formerly LXC) and Liferay PaaS (formerly LXC-SM). Issue This article describes how to get the Portal version and Patch level in the UI. Environment Liferay DXP 7.0+ Liferay PaaS 7.0+...

Requesting a New Feature or Feature Improvement

How To

Creating and Upvoting Feature Requests As an open-source company, Liferay has always valued community feedback and suggestions to help us continually improve our products. To request for a new feature or suggest enhancements to existing ones, post your ideas in the dedicated Product...

LXC-SMでMonitoringの画面から、細かくグラフの変化を見たいです。横軸を1分単位で表示可能でしょうか。

legacy How To

問題 LXC-SMのMonitoringの画面で、Start dateとEnd dateを同日に指定した場合、7分前後の間隔で横軸の値を確認できる様です。より小さい単位で横軸の値を確認したいです。環境 DXP 7.4 解決 1分単位の表示まで、小さく変更ができます。日付を指定した後、パラメータがURLの末尾に設定されますので、適宜短くなる様、調整ください。以下の例は指定範囲を1日分から1時間分に変更し、1分単位で横軸の値が表示される内容となります。変更前URL <該当箇所をデコードした表記...

Migrating Your 2024.Q4-2026.Q2 Database to PostgreSQL

How To

This article only applies to Liferay DXP versions between 2024.Q4 and 2026.Q2. For 2026.Q3+, see Migrating Your Database to PostgreSQL. Introduction Liferay adopted PostgreSQL as the default database for PaaS and SaaS projects in October 2024. Since then, all new Liferay PaaS and SaaS...

Liferay DXP Agent Fails to Start on Jakarta (Tomcat 10) Images with javax.annotation Error

Troubleshooting

Issue When using a Liferay DXP instance deployed on a Jakarta-based image (e.g., Tomcat 10), the liferay-dxp-agent bundle may fail to start. The logs will show an org.osgi.framework.BundleException error related to an unresolved package import. A key part of the error message will look...

Preventing host header attacks and stopping invalid host headers returning the default site

legacy How To

Issue Adjusting the Host header in the request can impact page rendering, redirections, and other server-side behaviors. This manipulation can lead to attacks such as cross-site scripting (XSS). If virtual.hosts.valid.hosts allows a host name that no site or virtual instance uses, a...

Configuring Service Probes

legacy

Service Probes should be configured based on your individual business needs. The following overview is meant to explain the basics of how Service Probes work, so that you can better make decisions about configuring them in your own environment. For more information on using and...

How long are the services logs stored in Liferay Cloud Console?

legacy

Note: please note that Liferay has renamed its Liferay Experience Could offerings to Liferay SaaS (formerly LXC) and Liferay PaaS (formerly LXC-SM). Issue Currently, through the web console, we only obtain the logs of the last 30 days. How long are the services logs stored in Liferay...

Web Contents statuses are not changing to expired even after expired date is over

legacy Troubleshooting

Note: please note that Liferay has renamed its Liferay Experience Could offerings to Liferay SaaS (formerly LXC) and Liferay PaaS (formerly LXC-SM). Issue Web Contents statuses are not changing to expired even after the expiration date is over. CheckArticleMessageListener is missing from...

SSL Certification isn't provided by Let's Encrypt, even though it is set up correctly

legacy Troubleshooting

Note: please note that Liferay has renamed its Liferay Experience Could offerings to Liferay SaaS (formerly LXC) and Liferay PaaS (formerly LXC-SM). Issue Let's encrypt isn't providing SSL certification to my custom domain, so I'm seeing a warning that my site isn't secure. I ensured...

Deploying Commerce Hotfix in Liferay PaaS

legacy How To

Note: please note that Liferay has renamed its Liferay Experience Could offerings to Liferay SaaS (formerly LXC) and Liferay PaaS (formerly LXC-SM). Issue How to deploy a Commerce hotfix in Liferay PaaS? Environment Liferay PaaS Resolution To install the .lpkg hotfix, you should delete...

Automated backup failure due to Error 408 (Request Timeout)

legacy Troubleshooting

Note: please note that Liferay has renamed its Liferay Experience Could offerings to Liferay SaaS (formerly LXC) and Liferay PaaS (formerly LXC-SM). Issue We have identified an incident where a backup failure may occur on automated backups due to an Error 408 (Request Timeout), and...

Liferay PaaS deployment stuck at jenkins

legacy Troubleshooting

Note: please note that Liferay has renamed its Liferay Experience Could offerings to Liferay SaaS (formerly LXC) and Liferay PaaS (formerly LXC-SM). Issue Deployment gets stuck at jenkins with below error: stderr: fatal: Unable to create...

Automate scripts for Search service in Liferay PaaS

legacy How To

Note: please note that Liferay has renamed its Liferay Experience Could offerings to Liferay SaaS (formerly LXC) and Liferay PaaS (formerly LXC-SM). Issue We need to execute a curl command for the Search service. Curl commands are not persistent, this means if the search service...

Preventing auto-deploy of builds to DEV

legacy How To

Note: please note that Liferay has renamed its Liferay Experience Could offerings to Liferay SaaS (formerly LXC) and Liferay PaaS (formerly LXC-SM). Issue When a new pull request merges to the develop branch, it auto-builds and deploys to the "dev" environment. How can this be prevented?...

Command-Line Tool installation in Linux Debian

legacy Troubleshooting

Issue After installing Command-Line Tool following instructions from https://learn.liferay.com/dxp-cloud/latest/en/reference/command-line-tool.html , the lcp command does nothing: username@mylaptop:~$ curl https://cdn.liferay.cloud/lcp/stable/latest/install.sh -fsSL | bash ... ... ......

Use Custom certificate and Let's encrypt at same time in different domains

legacy How To

Note: please note that Liferay has renamed its Liferay Experience Could offerings to Liferay SaaS (formerly LXC) and Liferay PaaS (formerly LXC-SM). Issue We need to have some domains with custom certificates and others using provided Let's Encrypt certificates. Is it possible setting...

Deployment issues using the App Manager in Liferay PaaS

legacy Troubleshooting

Note: please note that Liferay has renamed its Liferay Experience Could offerings to Liferay SaaS (formerly LXC) and Liferay PaaS (formerly LXC-SM). Issue You upload an application/plugin using the App Manager in DXP and you only see that it is deployed in only one instance, and from...

Deployment timeout when deploying backup service

legacy Troubleshooting

Note: please note that Liferay has renamed its Liferay Experience Could offerings to Liferay SaaS (formerly LXC) and Liferay PaaS (formerly LXC-SM). Issue Under certain circumstances, a new deployment fails with a timeout message around the 30 minute mark: Deployment timeout in 30m 13s...

OutOfMemory: Metaspace Liferay PaaS

legacy Troubleshooting

Note: please note that Liferay has renamed its Liferay Experience Could offerings to Liferay SaaS (formerly LXC) and Liferay PaaS (formerly LXC-SM). Issue Sometimes on the logs appears below error Caused by: javax.servlet.ServletException: java.lang.OutOfMemoryError: Metaspace This is...

Portal prints error stacktrace on the browser, disclosing technical information

legacy Troubleshooting

Note: please note that Liferay has renamed its Liferay Experience Could offerings to Liferay SaaS (formerly LXC) and Liferay PaaS (formerly LXC-SM). Issue When navigating some incorrectly crafted URLs (ex.:...

Missing Search Indices After Restart/Redeploy

legacy Troubleshooting

Note: please note that Liferay has renamed its Liferay Experience Could offerings to Liferay SaaS (formerly LXC) and Liferay PaaS (formerly LXC-SM). Issue Upon restarting or redeploying the search service, you may notice that Liferay indices may be missing within your environment....

Liferay SaaS Default Session Timeout

legacy

Note: please note that Liferay has renamed its Liferay Experience Could offerings to Liferay SaaS (formerly LXC) and Liferay PaaS (formerly LXC-SM). Issue What is the default value for user session timeout on Liferay SaaS? Environment Liferay SaaS DXP 7.4 Resolution The default session...

Custom domains do not accept wildcard

legacy Troubleshooting

Note: please note that Liferay has renamed its Liferay Experience Could offerings to Liferay SaaS (formerly LXC) and Liferay PaaS (formerly LXC-SM). Issue After modifying the webserver service to add new custom domains, the server doesn't start. The changes were added to the LCP.json...

aria-invalid="true" Attribute is Not Set for Required Checkbox Fields in Forms

legacy

Issue When a form with a required checkbox field is submitted without the checkbox being selected, the corresponding <input> element in the DOM does not receive the aria-invalid="true" attribute. This behavior is perceived as an accessibility issue, especially when compared to other...

How to use environment variables for passwords within OSGi config files

How To

Issue For security reasons, we would like to store passwords using environment variables within OSGi .config files. For example, to store the Elasticsearch server's password. Environment 7.3+ Resolution In Liferay versions containing LPS-123057, it is possible to use environment...

How to Enable an Audio CAPTCHA Challenge Using Google reCAPTCHA

legacy How To

Issue How can users enable audio for CAPTCHA verification? Environment Liferay DXP 7.4+ Resolution Liferay does not provide out-of-the-box (OOTB) support for audio CAPTCHA functionality. However, you can use Google reCAPTCHA, which offers an audio challenge: Integrate Google reCAPTCHA:...

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 status: available INFO May 15 14:54:44.856 1904 database 75b864bd48-zzc6n...

Deploying an EXT module on PaaS

legacy How To

Issue Deploying an EXT extension results in the extension being lost after the environment restarts. Environment Quarterly Releases 2023.Q3.3+. PaaS Resolution The use of EXT modules is discouraged. Please explore alternative extensions before proceeding, if possible. Starting from...

Path error for mariadb.jar

legacy

Issue Booting Liferay DXP 2025.Q1 we see in log file following error: May 22 11:37:49.551 build-3994 liferay[liferay-7c588c8bd4-mg686] [dxp] ERROR [main][StartupAction:68] Files [/opt/liferay/tomcat/lib/ext/mariadb.jar] in /opt/liferay/tomcat/lib/ext are no longer read. Move them to...

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 backup[backup-844b699f58-226cc] INIT CONTAINER SETUP-BACKUP-VOLUMES: Changing owner and...

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 LCP_PROJECT_MONITOR_DYNATRACE_TENANT and LCP_PROJECT_MONITOR_DYNATRACE_TOKEN variables are related to the Advanced Tab in the Monitoring section If these...

Hotfix fails on 2025.Q1: "Won't be installed: requires version 2025.q1.0-lts"

legacy Troubleshooting

Issue When we try to install a hotfix on Liferay DXP 2025.Q1, the Patching Tool shows this error: Currently not installed; Won't be installed: requires version 2025.q1.0-lts Environment Liferay DXP 2025.Q1 Resolution Upgrade to Patching Tool 4.0.7 or later. Older Patching Tool versions...

Troubleshooting Unresponsive UIs and ExpressionFactoryImpl Errors

Troubleshooting

Issue After upgrading, you may experience unresponsive user interfaces along with ClassNotFoundException messages in the Liferay logs. Depending on the page and component, symptoms include the Product Menu failing to open, buttons and menus not reacting, or pages returning an internal...

JS file caching

legacy

Issue How to enable the cache for the JS file? On each page refresh, all default JS is getting called, impacting site performance. Environment Liferay Paas Liferay Quarterly Release Resolution While refreshing the page, all default JS is getting called due to the Private - no...

How to retrieve Collection elements by the Collection's name using headless APIs

legacy How To

Issue Using Liferay's headless-delivery API, is it possible retrieve the elements of a Collection (called a ContentSet in APIs) based on the Collection's name? Environment Liferay DXP 2026.Q1+ Resolution Headless Delivery APIs at 2026.q1.0+ can retrieve a collection's elements by its key...

ConfigurationProviderUtil returns empty values for a custom configuration

legacy Troubleshooting

Issue A custom module reads a system configuration with ConfigurationProviderUtil.getSystemConfiguration, but the values it returns are empty. For example, this code returns an empty elasticServerHosts array, even though hosts are configured: import...

Using Zapier to Sync Object Data with Google Sheets

How To

Introduction You can use Liferay Objects with data integration tools to create automated tasks for syncing Object data with external services. These tasks are triggered using webhooks and can connect to Google applications, Microsoft Office, and more. This recipe guides you through the...

Designing and Displaying Reusable Navigation Menus

How To

Navigation menus for a site are typically tied strictly to a site's page hierarchy and structure. The Navigation Menus feature in Liferay is powerful because it enables you to create navigation menus that are decoupled from a site's page hierarchy. Liferay navigation menus can be driven...

Integrate Okta with Liferay DXP using OpenID Connect

How To

Introduction This recipe guides you through the steps to integrate Okta, your Identity Provider (IdP), with your Liferay environment using OpenID Connect. Prerequisites Okta Dev account Liferay DXP environment Administrative access to Okta Admin Console Administrative access to Liferay's...

Building Multi-Step Business Forms

How To

Introduction This recipe guides you through the basic steps to build a multi-step form. Prerequisites Liferay DXP environment An object definition with fields A user who has access and control to create and manage objects, display pages, and the ability to edit pages Steps Open the...

How to prevent a full day event from displaying on two days in the calendar's month view

How To

Issue When creating an all-day event that spans from 12:00 AM on one day to 12:00 AM on the next day, the event appears on both days in the calendar month view. How can I ensure the event is only visible on the first day? Environment Liferay DXP 7.4+ Resolution In the example, the event...

The "Menu Display" text appears in the Navigation Menu widget

Troubleshooting

Issue After a failed login attempt, the navigation menu's display text appears above the menu itself. Steps to reproduce: Create a site. Create a login page and deploy the sign-in widget. Create a navigation menu. Create a master page template and deploy the navigation menu on the master...

How to deploy a custom JAR to the shielded-container-lib directory in my PaaS Environment

How To

Issue I would like to know how to deploy a custom JAR to the shielded-container-lib directory of Tomcat in my PaaS environment. Environment Liferay PaaS Resolution Follow these steps: In your Liferay Workspace, create the following directory structure:...

"Could not resolve value from secret references" error deploying build in PaaS

Troubleshooting

Issue When deploying a build in my Liferay Cloud PaaS environment, the build process fails and returns the following error message: Some error has happened during the build. Try again. [{"message":"Could not resolve value from secret references","name":"Error"}]. Environment Liferay PaaS...

How can I disable the Commerce Wish List creation

How To

Issue I have an issue with the commerce wish list table in the database. The table has lots of entries and it is growing more, even though we do not use the wish list feature. I would like to remove these entries and disable the creation of the wish lists. Environment Liferay DXP 7.1+...

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

Forgot Password Accepts Any Email Address Without Validation

Issue The Forgot Password option does not validate if the user enters a correct email address. You can enter anything and the field accepts it. Two types of validation are expected: Email format validation (to ensure the entered email address follows a valid format). Existing email...

Sorting Structures by Name in Liferay DXP

Troubleshooting How To

Issue The order of Structures when creating Web Content seems to be random. The structures are not sorted alphabetically or by modification date. Environment Liferay DXP 2024.Q2 Resolution Web Content Display widget Go to Control Panel > Instance Settings > Content and Data > Web Content...

Restricting the Guest Role's Access to the Home Page

Troubleshooting

Issue When trying to change the view permission of a page it's not possible to do it for the Guest role in the first page: it shows as non-interactive. Environment QR 2024.Q3, 2024.Q4, 2025.Q1 Resolution This is the expected behavior for the guest site in a given instance. For the guest...

How to Compare Between Versions When Using Workflow

Issue Is it possible for a reviewer to compare both the Old and New versions when a user makes changes and resubmits for workflow approval in Web Content, Document & Media, and Commerce Products? Environment Liferay DXP 7.4+ Quarterly Release Resolution Web Content: Web Content allows...

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

Add New Custom Domains and Avoid Downtime while Let's Encrypt certificate Is Generated

legacy Troubleshooting

Issue When new custom domains are appended to to the existing list under "customDomains" in the "certs" part of the webserver LCP.json file, a new Let's Encrypt certificate is issued to include them. In the mean time the old domains will appear as having no current certificate. Is it...

How to clear the data folder of Glowroot in Liferay PaaS

legacy How To

Issue How to clear the data folder of Glowroot in Liferay PaaS. Environment Liferay DXP 7.4 Liferay PaaS Resolution To clear the data folder through the Glowroot UI. Follow the below steps: 1. Visit the site and log in. 2. Append /o/glowroot to the end of the site’s URL. For example, if...

Search Results