Site Search - Liferay Learn

CKEditor Customizations Not Applying to Translations or Forms

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

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

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

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

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

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

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

ClayDatePicker making everything inaccessible

legacy Troubleshooting

Issue We've discovered that the page becomes unresponsive when using the ClayDatePicker in a react element. Steps to reproduce: Click on Date Picker Field Click on year dropdown within the Date Picker Without...

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

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

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

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

Content created within Publication is searchable using the search results widget but not via Blueprint

legacy Troubleshooting

Issue Steps to reproduce: Navigate to Control Panel->Applications->Publications and Enable Publications. Click on the "+" button and add 2 new publications as Dev 1 and Dev 2. Create web content for each...

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

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

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

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

Unable to Provision Users via SCIM

legacy Troubleshooting

Issue User provisioning via SCIM is failing. Liferay logs indicate a permission error: ERROR [org.wso2.charon3.core.protocol.endpoints.AbstractResourceManager] Unable to provision a portal user for null...

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Console errors when local staging is on

legacy Troubleshooting

Issue There is a staging initialization failure within the console when local staging is on. Steps to reproduce: Publishing > Staging > Toggle Local Staging On Navigate to the Home Page and check the console within...

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

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

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

Certificate Renewal Failing with 403 Error on Liferay PaaS

legacy Troubleshooting

Issue When attempting to renew the SSL certificate generated by Let’s Encrypt, the process fails with multiple 403 (Forbidden) errors. The error messages suggest a security restriction that is preventing the...

Expiring license error occurs in clustered environment for Liferay PaaS

legacy Troubleshooting

Issue The following expired licensing error displays in Liferay PaaS logs: ERROR [main][LicenseManager:-1] Digital Enterprise Unlimited Enterprise-Wide license is expired Environment Liferay PaaS Resolution There are two...

Adaptive Media Images Not Displaying for Users in Product Catalog Search Results

legacy Troubleshooting

Issue When using Adaptive Media with images in Product Catalog search results, the images are displayed correctly for some users, but not others. For example, Adaptive Media is not working for...

Web Content "Modified by" User Appears to be Incorrect After Translation

legacy Troubleshooting

Issue After translating existing web content, the last modified user displayed is the original author, not the translator. Environment Liferay DXP 7.4+ Resolution The "Modified by" user and timestamp for web content...

Insufficient Permissions to Access Folders When Uploading Documents to Web Content

legacy Troubleshooting

Issue Users with a role other than Administrator, for example, the "Editor" role, receive a permissions error when they try to access folders within Documents and Media while uploading a document to Web Content. The...

Changing the Displayed Time Zone for Audit Logs

legacy Troubleshooting

Issue Even after changing the time zone for the instance within the Instance Settings, the time zone for the Create Date for the logs in Audit are still displayed in UTC. Environment Liferay DXP 7.4 Quarterly Release...

Localizing Object Definitions.

legacy Troubleshooting

Issue We do not find where is the feature to get objects localization. Based on following documentation...

How to configure X-Pack secured search service liveness/readiness probes with authentication in Paas

legacy Troubleshooting

Issue We tried to configure in our PAAS environnement the Elasticsearch X-Pack feature. When we follow this article and enable X-Pack feature in dev server (with environment variable), the ElasticSearch endpoint used for...

"http://localhost:8080/o/oauth2/authorize" URL redirect to the Login Page

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 accessing the OAuth2 authorization URL...

Getting BadPaddingException errors in the logs after an upgrade

legacy Troubleshooting

Issue After upgrading Liferay DXP, javax.crypto.BadPaddingException errors appear in the logs when using 'Auto Login' feature ('Remember me'). Example error message: ERROR [AutoLoginFilter:247] Current URL /home...

java.sql.BatchUpdateException: data exception: string data, right truncation from long client extension service names

legacy Troubleshooting

Issue When deploying a client extension, you may encounter an error, that can be traced to a BatchUpdateException, such as the following: Caused by: java.sql.BatchUpdateException: data exception: string data, right...

SAML Logout Issues: Multiple Login Entries and Optimistic Locking Exceptions

legacy Troubleshooting

Issue When a user logs out after authenticating via SAML, multiple login entries might be recorded in the audit logs. This can lead to HibernateOptimisticLockingException errors, particularly during...

Data Migration Center: Unable to Import CSV file

legacy Troubleshooting

Issue The issue only occurs when the field is being translated, using objects alone does not cause it. Steps to reproduce 1. Navigate to the Applications Menu and click on Data Migration Center. 2. In that, click...

Unable to Import Site Template LAR

legacy Troubleshooting

Issue Import of a LAR file exported from a Site Template through Publishing -> Export fails when being imported to another environment with an error stating: The LAR file could not be imported because it requires page...

In SAML setup user is not getting login in the SP and receiving warning on the UI

legacy Troubleshooting

Issue After setting up the SAML process, the user tries to log in receiving the warning below and not being logged in. Environment Liferay 2023.Q4.0 Resolution If users are setting up an identity provider as...

SAML Authentication Error: "This message decoder only supports the HTTP POST method

legacy Troubleshooting

Issue The following SAML errors appear in the Liferay logs: ERROR [http-nio-8080-exec-5][BaseSamlStrutsAction:53] org.opensaml.messaging.decoder.MessageDecodingException: This message decoder only supports the...

The assignments are missing between roles and user groups when transfer from one enviornment to another

legacy Troubleshooting

Issue The export/import of UserGroups and Roles does not contain the assignments between roles and user groups. So when 'transporting' the user groups and roles from one stage (or backup) to another stage (new...

Duplicate files in Liferay theme WAR file

legacy Troubleshooting

Issue When building a Liferay theme using Liferay Developer Studio, multiple versions of CSS and JS files are created in the WAR file. Environment Liferay DXP 7.4 Resolution To prevent duplicate files in...

Why cannot see Publications after upgrade?

legacy Troubleshooting

Issue After making the upgrade from Liferay 7.4 update-46 to Liferay 7.4 Quarterly Release Q2 2024 user cannot see the Publications. Environment Liferay DXP 7.3 Liferay DXP 7.4 Resolution Consider to verify...

Unexpected SAML calls: com.liferay.saml.internal.servlet.filter.SpSessionTerminationSamlPortalFilter.doProcessFilter

legacy Troubleshooting

Issue When navigating through the portal with SAML disabled, there are a few SAML-related filters that are still being processed, leading to database calls and causing slower performance. at...

Impersonated user is unable to add items to the cart

legacy Troubleshooting

Issue When impersonating a user with permissions to add items to a cart, a message is seen in the UI, which says: “Danger: [object Object]” and the items do not get added to the cart. This behavior can be...