Site Search - Liferay Learn

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

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

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

Automatic Fragment Propagation and Liferay startup time

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 Customers with a large number of Content Pages extensively...

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

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

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

Filtering Products by Category via API

legacy Troubleshooting

Issue I need to display related products on a product details page, filtered by a specific category. Attempts to filter products by category using an Information Template and API calls with...

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

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

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

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

Default Language not being applied to not translated content

legacy Troubleshooting

Issue There is an undesirable behavior present when creating an object and utilizing the language translation. The content is empty instead of showcasing the content translated. Steps to reproduce: Instance Settings...

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

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

Calendar Widget displays Custom fields differently

legacy Troubleshooting

Issue When users create Custom fields via Control Panel → Custom Fields → Calendar Events, Custom Fields are not displayed in the same way as Native/Non-Custom fields when viewing Calendar Event details. Environment...

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

Search Bar text suggestions does not show content created in a publication

legacy Troubleshooting

Issue Steps to reproduce: Navigate to Control Panel->Applications->Publications and Enable Publications. In Production, create a web content “testProd” Create a new publication P1. In P1, create a web content...

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

Image uploaded from the Document and Media is blur as compared to image uplaoded from tomcat ROOT folder

legacy Troubleshooting

Issue When the image is uploaded in the system using the Document and Media and also using the ROOT folder of the tomcat server (/tomcat-9.0.75/webapps/ROOT/html), then the image uploaded from the Document and...

LCP Command Fails with "UNABLE_TO_GET_ISSUER_CERT_LOCALLY" Error

legacy Troubleshooting

Issue When deploying a microservices client extension using the LCP command in a Liferay Cloud environment, the command fails with the following error message: UNABLE_TO_GET_ISSUER_CERT_LOCALLY. Environment...

Unable to edit documents after rejection in workflow

legacy Troubleshooting

Issue User is unable to edit documents after they are rejected in a single approval workflow. The edit buttons are disabled, which prevents them from making changes before resubmitting. Steps to Reproduce: Log in...

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

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

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

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

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

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

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

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

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

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

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

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

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