Site Search - Liferay Learn

Using Zapier to Sync Object Data with Google Sheets

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

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

CKEditor Customizations Not Applying to Translations or Forms

Troubleshooting

Issue Customizations made to CKEditor using an `EditorConfigContributor` are only applying to the editor when editing Web Content, but not in the editor for translations (accessed through Control Panel > Content Actions > Translate) or in paragraph fields within Forms. Environment...

Freemarker templates escape HTML content in Text fields after migrating from Liferay DXP 7.3 to 2025.Q1

Troubleshooting

Issue After migrating from Liferay DXP 7.3 to 2025.Q1, HTML content within web content "Text" fields is no longer interpreted by Freemarker templates using ${field.getData()}. It is displayed as escaped HTML. Environment Liferay DXP 7.3 Liferay DXP 2025.Q1+ Resolution Use the following...

How to Configure PaaS to Push Metrics to Dynatrace Account

How To

Issue What is the correct way to configure our new PaaS environment to push metrics to a Dynatrace account? Environment DXP 7.4 Resolution Set the following environment variables in LCP.json LCP_PROJECT_MONITOR_DYNATRACE_TENANT → A string of characters that is part of the URL (prefix)...

Finding your Liferay Cloud location via egress IP address

How To

Issue The ingress IP address of our Liferay Cloud instance shows a different location than expected. Environment Liferay PaaS Resolution The ingress IP address does not reflect the actual location of the specific regional data center where your environment is hosted. The ingress IP...

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

Content lost when changing language during creation

Troubleshooting

Issue When creating content, such as a calendar event or filling a form, changing the language during the process can cause the loss of all entered information. This can happen if another browser window or tab is open in a different language, or if the language is changed manually using...

Translatable fields display empty after deleting field translation instead default translation

Troubleshooting

Issue When adding content to a translatable field in a structure and subsequently deleting the content in a secondary language, the field displays as empty in that specific language instead of falling back to the primary language. If a translatable field has never had content in a...

Liferay and CVE-2025-24813

legacy

Issue Does Liferay DXP have the vulnerability CVE-2025-24813? Environment Liferay DXP Quarterly Releases 2025.Q1 Resolution Liferay bundles and docker images are not affected due to the attribute readonly in DefaultServlet is true by default. To be exploitative readonly must be false. ...

Can Layouts Be Dynamically Assigned to Object Entries Based on Experience (e.g., User Role)?

Issue I’ve created an Object named TestObject and added two layouts: Test Layout 1 and Test Layout 2 in the Site Builder → Pages section. Behavior observed: If no layout is marked as default, the system uses the default Liferay layout — as expected. If one is marked as default, it...

Changes to Content Page Template Not Propagated to Pages

Issue After creating a Content Page Template and then creating pages based on that template, any subsequent changes and publishing of the template do not reflect on the pages using the template. Environment Quarterly Releases Resolution This behavior is expected. Changes to a Content...

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

Monotype Font Licensing

Issue Usage of Monotype fonts require a license If a user does not have the Monotype font license, is it necessary to remove references to Monotype font throughout the portal? Environment Liferay DXP 7.4 Resolution Monotype fonts, such as Helvetica, is referred to in the Liferay CSS...

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

Implementing strict rules for virtual hosts and friendly URLs

legacy Troubleshooting

Issue Having the different URLs for the same content could potentially impact SEO by affecting how pages are indexed. Even when a virtual host is defined for a site, it is possible to access that site using the portal-wide virtual host and IPs as well as the virtual hosts for other...

Email Address Validation for Forgot Password

Issue The Forgot Password option does not validate if the user enters a correct email address. You can enter anything and the field will accept 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...

"Inconsistent patch level detected" error occured in the logs

Troubleshooting

Issue The following error occurs in the logs due to an inconsistency in patch levels: Example 1: ERROR [server.startup : 2][PatcherImpl:204] Inconsistent patch level detected WARN [server.startup : 2][PatcherImpl:212] Patch level on portal-impl.jar: [dxp-28-7110, hotfix-xxxx-7110] WARN...

Hotfix created for 2025.Q1.X won't install

legacy Troubleshooting

Issue A hotfix created for 2025.Q1.X won't install even though it is being installed on the required version. The following information appears in the patching-tool info file. Product information: * DXP version: 2025.Q1.0 LTS * Patching Tool version: 4.0.5 * Time: 2025-03-03 20:44Z...

Structures showing as 'Not Translated' after upgrading to 7.4+

Troubleshooting

Issue After upgrading from Liferay DXP 7.3 (or prior versions) to 7.4, some Web Content Structures are showing as not translated in the UI, even though the translations exist in the database. The structure's fields may be translated, but the structure itself is marked as not translated....

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

User profile is visible when accessing the /web/test

legacy Troubleshooting

Issue When accessing localhost:8080/web/test, the user profile is visible to guest users. The concern is that the user data being accessible to guest users poses a security threat. Environment Liferay DXP 7.4 Resolution Add the below property in portal-ext.properties file and set this to...

Organization tab do not shows the user when user is added to organization via Groovy Script

legacy Troubleshooting

Issue After the execution of the below syntax in the Groovy Script, the Organization name gets appended to the user and can be seen only under the "User's details Organization Tab" but not under the "Organizations tab". import com.liferay.portal.kernel.service.*; out.println...

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

Downloading Large Log Files from Liferay Cloud

legacy Troubleshooting

Issue Unable to download complete log files from the Liferay Cloud console. The downloaded file size appears truncated. Environment Liferay PaaS Resolution The Liferay Cloud console limits log file downloads to 10,000 lines to prevent performance issues. To retrieve more logs, use the...

How to Redirect a non-www Domain to a www Domain in Liferay DXP

legacy How To

Issue How can I redirect traffic from my non-www domain (e.g., example.com) to my www domain (e.g., www.example.com)? Environment Liferay DXP 7.4 Quarterly Releases Resolution You can configure a redirect using Liferay's pattern redirect feature: Access your website and navigate to Site...

Liferay shows SQL Syntax errors when connected to MariaDB 10.3+ in Oracle_Mode

Troubleshooting

Issue When connecting my Liferay server to MariaDB 10.6, I get the following error when creating a widget page: (conn=143451) You have an error in your SQL syntax; check the manual that corresponds to your MariaDB server version for the right syntax to use near 'body, lastPublishDate,...

Can Liferay pass User Roles to the Service Provider?

legacy

Issue In a SAML configuration where Liferay acts as the Identity Provider, is Liferay able to pass its User Roles to the Service Provider? Environment Liferay 7.4 Resolution Yes, it is possible. Liferay will send the User Role information as an Array of Strings containing User's...

NoSuchFileEntryException when updating web content with images in a task executor

legacy Troubleshooting

Issue When updating web content within a task executor, if the web content structure includes an image field (fileEntry), the update JournalArticle updateArticle(article.getUserId(), article.getGroupId(), article.getFolderId(), article.getArticleId(),article.getVersion(), content,...

Most Viewed Assets Portlet Ignores Category Filters

legacy Troubleshooting

Issue We created our categories programmatically (using APIs). These categories are ignored by the Most Viewed Assets portlet. Even with category filters configured, the portlet shows assets based on views only, including assets not belonging to the selected categories. Environment...

Admin UI breaks after changing site default language

legacy Troubleshooting

Issue After changing a site's default language to a non-English locale and disabling English (United States) support, the Admin UI breaks. The issue occurs when the "Use Localized URL" option is selected in the Instance SEO Configuration before changing the site's default language. Steps...

"Select Master Page is temporarily unavailable" when trying to add a Display Page Template

legacy Troubleshooting

Issue I want to add a Display Page Template and I get the following error: In the logs, I see: 2025-02-10 18:18:39.160 ERROR [http-nio-6080-exec-8][PortletRequestDispatcherImpl:295] Unable to dispatch request: com.liferay.info.exception.CapabilityVerificationException: Failed validation...

Request to /o/change-tracking-rest/v1.0/ct-collections returns 403

legacy Troubleshooting

Issue When accessing Publications through the UI, they are not displayed. The request to `/o/change-tracking-rest/v1.0/ct-collections` returns a 403 Forbidden error when it goes through the Web Application Firewall (WAF). Environment DXP 7.4+ Publications feature enabled. Web Application...

"Interval is either equal or less than 0" error is produced during the upgrade and checkInterval is reset to zero

legacy Troubleshooting

Issue When upgrade from 6.2 to 2024.Q4, following error is produced in the log files: 2025-02-11 20:48:20.910 ERROR [main][ROOT:47] bundle com.liferay.journal.web:5.0.180 (1238)[com.liferay.journal.web.internal.scheduler.CheckArticleSchedulerJobConfiguration(10891)] : The activate method...

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 Exclude User Names (userName field) from Search Queries in Liferay

legacy How To

Issue We want to exclude the userName field from search queries. This is to prevent irrelevant search results based on user names. For instance, if a user's name contains a common search term, Liferay will return content and documents created by that user, even if the content itself does...

Dynamic Blueprint parameters with Search API

legacy How To

Issue Blueprints offer static filtering by field values, but a dynamic approach is needed where search fields enable filtering based on user-provided values for specific structure fields, Is possible to provide custom parameters to Search Blueprints? How can I create a search experience...

Collection Display Fragment is not responsive when using the CSS Medium Screen Size (col-md)

legacy Troubleshooting

Issue We've observed that when using the Collection Display fragment to display a collection of data/items and selecting the medium screen size (col-md), the responsiveness becomes unreliable. Environment Quarterly Release 2023.Q4 and below Resolution There is a workaround available,...

XSS Vulnerability present when using Web Content Article's source code

Troubleshooting

Issue We've observed a XSS Vulnerability present when using Web Content Article's source code. This vulnerability appears to be present when involving the deployment of a payload via the source code. Steps to reproduce: Create a Web Content Article Edit the <> Source Code and add the...

SAML - Can you end the Identity Provider's session when the Service Provider's session times out?

legacy Troubleshooting

Issue We have Liferay configured as a SAML Service Provider (SP), and we use third-party software as the Identity Provider (IdP) Our IdP is used for multiple applications, so its session timeout is set for a longer timeframe than any of the Service Providers'. When the session ends in...

Is integration of mTLS possible in Liferay?

legacy How To

Issue We are required to use mTLS (Mutual Transport Layer Security) for certain requests Is it possible to integrate mTLS with Liferay? Environment DXP 7.4 Quarterly Releases Resolution Yes, it is possible to make the integration with mTLS Server side setup: Ensure the Identity Manager's...

The site name is appended to every Event/Meeting created in Liferay Calendar

legacy

Issue The site name is appended to every Event/Meeting created in Liferay Calendar. Environment DXP Quarterly Release 2024.Q2.0 Resolution Liferay calendar displays the site name as default when the event or meeting creator is not specified. A new feature request has been created to hide...

Impersonation Clashes with Cached Web Content Templates

legacy Troubleshooting

Issue Web Content Templates can be configured for caching to boost performance. When not cached, the generated HTML is rendered for each request. When cached, the generated HTML is stored in the cache and reused for all subsequent requests until the cache entry is cleared or expires....

Web Content Not Displayed in Context in Search Results

legacy Troubleshooting

Issue Some web contents are not displayed in context when accessed from search results with the "Display selected search result in context" checkbox selected. For web contents displayed in an asset publisher, the correct context is the page containing the asset publisher displaying the...

How to modify the Cache-Control header to prevent browser caching issues

Troubleshooting

Issue After deploying a new version of my theme, users are experiencing issues due to old Javascript files being loaded from the browser cache. Thus, we would like to modify the Cache-Control header of those resources. Environment Liferay DXP 7.3 Resolution To avoid these problems, the...

Cannot add the Indonesia or Hebrew language to instance after changing locale codes to ISO 639 language codes

legacy Troubleshooting

Issue From Java 8 to Java 17, changes were made in locale support, specifically with the language codes for Hebrew(Israel) and Indonesian(Indonesia), according to this article:...

How to create Web Content with large images from text file?

legacy Troubleshooting

Issue Copy-pasting large images from text file prevents the Web Content from being published, although it appears correctly in the editor. Environment Liferay DXP 7.4 Resolution When images are copy-pasted from a text file, the editor will store them in raw data format. Storing images...

How to preserve the structureId and formId during export/import to avoid mismatches between environments?

legacy Troubleshooting

Issue When we export/import web content articles and forms, their IDs sometimes change. How to preserve the structureId and formId during export/import to avoid mismatches between environments? Environment DXP Quarterly Release 2024.Q3.0 Resolution Entity IDs are not preserved during...

Modified date not match the author of a web content, document or any other asset.

legacy

Issue The author displayed for content/documents is inconsistent when modifications are made by users other than the original author. When a user edits and publishes the content, the displayed author is correctly updated to the user who published the latest version. However, if the...

Handling an excess number of User Notifications

legacy Troubleshooting

Issue As my Liferay system sends out User Notifications over time, the UserNotificationEvent table accumulates many records quickly. I would like to schedule the cleanup of old User Notifications, so that the table's size remains manageable Environment DXP 7.4 Resolution There are a few...

Email Settings not resetting completely from Instance Settings

legacy Troubleshooting

Issue If a user wants to reset Mail Settings from Instance Settings, it is not resetting completely Environment SaaS Resolution Open a Help Center ticket to have Support manage the environment Additional Information LPD-25567 , knowledgeArticleType: troubleshooting, legacy: true,...

Is it possible to create Style Books directly from a Client Extension?

legacy

Issue Is it possible to create Style Books directly from a Client Extension? Environment DXP Quarterly Release 2024.Q4.0 Resolution Client Extensions can be created to modify the Liferay backend elements, like the Style Book. The following feature is also being developed: LPD-30204...

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