Site Search - Liferay Learn

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

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

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

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

User did not provide a valid CSRF token Error

Troubleshooting

Issue Portlet Action requests intermittently returning a 403 error code. In the logs the following error message regarding invalid CSRF token gets printed whenever the 403 error is thrown. "User [user_id] did not provide a valid CSRF token for...

Session timeout warning message does not show the counter

Troubleshooting

Issue I have an issue with the session timeout message. After upgrading from DXP 7.1 to Quarterly Release, when a user session is about to expire, they receive a warning message that their session will expire in a certain time and that they should extend it if they wish to stay logged...

Uncaught TypeError: Liferay.Notification is not a constructor

Troubleshooting

Issue Adding the below script to any page through any Web content display can reproduce the issue in vanilla. <a href="#" onClick="showWltNotification('Your Request failed to process', 'danger');"> Link here </a> <aui:script> function showWltNotification(message, type) { ...

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

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

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

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

Login URL Parameters Reported as Security Threat

legacy Troubleshooting

Issue Vulnerability Assessment and Penetration Testing (VAPT) reports the parameters passed in the login request as a security threat. How can these parameters be removed or mitigated? Environment Liferay DXP 7.4+ Resolution Liferay DXP uses specific URL parameters for the LoginPortlet...

"Copy Page" button doesn't copy the page contents properly

legacy Troubleshooting

Issue We have observed that the "Copy Page" button in the kebab menu of the pages search result screen does not work as expected. The content of the source and destination pages are changed during the copy process. Environment DXP 7.3 Resolution This behavior was fixed in Liferay 7.4...

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

Documents and Media images Not Visible to Guest Users

legacy Troubleshooting

Issue Images and files uploaded to Documents and Media are not visible to guest users, even with "View" permission granted to the Guest role. Environment Liferay DXP 7.4 [and above versions] Resolution Guest users require both "View" and "Download" permissions in Documents and Media to...

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

Password syntax checking error does not appear when configuring with Minimum Lowercase 1 when creating a new account

Troubleshooting

Issue I have an issue with checking the password syntax. When they configure the password syntax with Minimum Lowercase 1, Minimum Symbols 1, and Minimum Uppercase 1, try to create an account for a guest user, type a wrong password, the account creation is rejected but the password...

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

Search Result Limit Resets to 10000 After Container Restart

legacy Troubleshooting

Issue We changed the index.search.limit property in portal-ext.properties We also set the same value in Control Panel -> System settings -> Search -> Elasticsearch 7 -> Max Result Window The search result limit reverts to 10000 after container restarts. Environment Quarterly Releases...

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

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

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

Unable to Save Forms After Enabling ModSecurity

legacy Troubleshooting

Issue After enabling ModSecurity with the default settings, forms with more than three fields cannot be saved. The following error message is displayed in the logs: ModSecurity: Access denied with code 400 (phase 2). Matched "Operator `Eq' with parameter `0' against variable...

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

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

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

Documents and Media widget displays "Copy to" action for Guest users

legacy Troubleshooting

Issue The "Copy to" option is displayed in the Documents and Media widget for Guest users, even though they lack the necessary permissions to perform this action. This can lead to a poor user experience, as clicking on the option results in a 404 error. Steps to reproduce: Add a...

Unassign Site Template from a Site / Export a site without the template it was based on

legacy Troubleshooting

Issue Is there a way to unassign a Site Template from a Site? When importing a site using a .lar file into a company where the associated Site Template doesn't exist, an error occurs: "Site cannot be Imported as Site Template does not exist." Environment DXP 7.4+ Resolution There's no...

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

Old version of an updated file gets downloaded instead of the new version

legacy Troubleshooting

Issue Some team members had to go into the 'Current Assets' asset library and re-version some files that needed updating. After re-versioning the files, when Person A went to download the files to see how their changes looked for the customers, they were downloading the previous version...

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

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

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

Liferay instance node going into hang mode - Failed to validate connection

legacy Troubleshooting

Issue Liferay instance node goes into hang mode and the following error appears: HikariPool-1 - Failed to validate connection ... (This connection has been closed.) ... Possibly consider using a shorter maxLifetime value. Environment DXP 7.4 PostgreSQL Resolution We strongly recommend...

Vulnerabilities reported in classes generated by Liferay Service Builder

legacy Troubleshooting

Issue While performing security scans, there are vulnerabilities found in custom classes that are generated by Liferay Service Builder. Environment Liferay DXP 7.4 Resolution Sometimes, these warnings are false positives. The reason behind this is that this is generated code (classes...

Updating Custom Account Entry Fields Fails for Person Accounts with a Specific Role

legacy Troubleshooting

Issue 'users do not have permission' exception is showing when trying to update the same custom field on Person type accounts. Steps to reproduce: 1. Start a clean 2024.q1.1 bundle 2. Navigate to configuration > custom fields > account entry > new 1. In the New Custom Field, select...

Updates are not visible without a page refresh

legacy Troubleshooting

Issue After editing and publishing a fragment or page, the changes are not immediately visible, but a similar behavior could be reproduced in other ways. A manual page refresh is required to see the updated content. Environment Liferay DXP 7.0, 7.1, 7.2, 7.3, 7.4 Quarterly Releases...

"HTTP Status 400 – Bad Request" error occured when Updating Blogs' Custom Friendly URL

legacy Troubleshooting

Issue While updating the "Blogs" custom-friendly URL from "/liferay-blog" to "test-blogs/liferay-blogs," an HTTP Status 400 - Bad Request error appears on the UI. (A video demonstrating the issue has been attached.) Steps to Reproduce Start the Liferay bundle. Navigate to Product Menu >...

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