Site Search - Liferay Learn

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

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

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

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

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

'Error: Please enter content with valid content size no larger than 1 MB' when using Liferay Forms

legacy Troubleshooting

Issue When I am saving a form with a large amount of data, I get the following error: Error: Please enter content with valid content size no larger than 1 MB. Environment Liferay Quarterly Releases Resolution...

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

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

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

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

After Enabling Publications, Some Notifications are Listed as "Deleted" in the UI

legacy Troubleshooting

Issue When Publication is enabled, some notifications are unexpectedly displayed as "deleted" in the Notifications UI, even though the related workflow tasks and assets are still present and accessible....

Portlet 3.0 Control Panel Apps cause unexpected errors

legacy Troubleshooting

Issue Following the deployment of a Portlet 3.0 Control Panel App, other areas of the control panel are experiencing malfunctions. For instance, the My Sites selector is not responding, and in version 7.3, the Global...

LIFERAY.HEADLESS.DELIVERY scope missing or delayed in OAuth 2 applications

legacy Troubleshooting

Issue The LIFERAY.HEADLESS.DELIVERY scope is missing or delayed in appearing when creating or managing OAuth 2 applications. The issue can occur intermittently, with the scope sometimes appearing after a delay of...

Audit Events filtered by date/time are not being exported accurately

legacy Troubleshooting

Issue When using using the Audit Export Feature, filters for date and time are not applied accurately in the resulting CSV file. The exported file may not include entries explicitly requested by the filter. For...

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

Troubleshooting

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

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

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

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

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

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

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

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

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

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

400 Bad Response When Filtering Using the API on Custom Fields

legacy Troubleshooting

Issue When filtering using the API on a custom field of type "long integer" (for example: customID eq '123'), I get a bad request response; but when I use the same syntax on an out-of-the-box field with type "long...

"Current license is non-compliant for [security]" error is shown in the log

legacy Troubleshooting

Issue We tried to restart the Liferay server but the server is not able to start properly, there is an error in the log: ERROR [localhost-1][com_liferay_portal_search:103]...

Users are redirected to home page on SAML sign-in in a clustered environment

legacy Troubleshooting

Issue Users are sometimes redirected to the home page on login rather than their page of entry. The environment is clustered with SAML authentication, and the property auth.forward.by.last.path is set to true....

View Count on Display Page not updated in index

legacy Troubleshooting

Issue The values viewCount or viewCount_sortable are not being updated when users visit content displayed on a Display Page. However, the values are correctly updated in the ViewCountEntry table....

Re-enabling CCR, errors appear indicating that an open index with the same name already existed

legacy Troubleshooting

Issue In a CCR scenario where the leader cluster is down and the system continues operating by reading and writing to the follower after disabling CCR, an HTTP/1.1 500 Internal Server Error occurs when attempting...

Elasticsearch is not starting up receiving NoNodeAvailableException and JNA native support exception

legacy Troubleshooting

Issue Elasticsearch is not running properly, receiving the below errors: ERROR [liferay/search_writer/SYSTEM_ENGINE-371][ElasticsearchIndexWriter:143] java.lang.RuntimeException:...

Typing delay when editing fields in articles with too many fields

Troubleshooting

Issue I have a web content structure with multiple fields. When I create a web content from the structure, and add several fields (more than 100 entries), I experience delay while typing on the field and JS errors...

PortletPreferenceValue for Announcements widget does not change for content pages when upgrading from Liferay 7.2 to 7.4

legacy Troubleshooting

Issue When upgrading from Liferay 7.2 to 7.4, the settings stored in the PortletPreferenceValue for the out-of-the-box Announcements widget does not change post-upgrade. The issue specifically affects content pages...

"The server could not start in 900 seconds" error occurs when starting server in Liferay Developer Studio

legacy Troubleshooting

Issue Liferay server crashes when running under Liferay Developer Studio for 15 minutes, reporting the following error dialog: The server could not start in 900 seconds. Environment Liferay...

Upload attachments to custom objects Headless API

legacy Troubleshooting

Issue Create a custom object having an attachment field. Error 400 when trying to create an object using this field. { "status": "BAD_REQUEST", "title": "The value is invalid for object field...

Style books error ORA-00904: "MVCCVERSION": invalid identifier_

legacy Troubleshooting

Issue When attempting to create or import a Style Book, the following error appears in the logs: ORA-00904: "MVCCVERSION": invalid identifier. Environment DXP 7.3 SP3 DXP 7.4 Update 4 Resolution This...

"Cannot use import statement outside a module" JS error with a custom form field type

legacy Troubleshooting

Issue After creating a new form field type (e.g. blade create -t form-field ...) or upgrading a custom form field type to a newer version, a JavaScript error is displayed in the console when dragging...

ElasticsearchStatusException[Elasticsearch exception [type=search_phase_execution_exception, reason=all shards failed]]

legacy Troubleshooting

Issue We are getting lots of following messages in log: ERROR [http-nio-8080-exec-3][ElasticsearchIndexSearcher:152] [] null java.lang.RuntimeException: org.elasticsearch.ElasticsearchStatusException:...

High CPU and memory use with stacktraces associated to password encryption

legacy Troubleshooting

Issue The environment starts using a large amount of CPU and also memory. Reviewing thread dumps taking during that time, there are many threads associated to PBKDF2PasswordEncryptor.encrypt, such as:...

Accessing HTTPS services through VPN Connection

legacy Troubleshooting

Issue Multiple security/certificate/host errors can occur when trying to access an internal HTTPS service through a SaaS/PaaS VPN connection. Environment Liferay PaaS/SaaS client-to-site VPN connection....

When accessing Web Content after a restoring to a backup, the following message is seen: "Result Found With Filters Type: Versions"

legacy Troubleshooting

Issue After restoring to a backup, when looking Content and Data > Web Content it displays the following message: 1 Result Found With Filters Type: Versions Environment DXP 7.4 Resolution When a Web Content Article is...

Zendesk Click-to-Chat uses "screenName" instead of Actual Name for Tickets/Claims

legacy Troubleshooting

Issue The Zendesk Click-to-Chat widget uses the claim screenName, instead of the user's actual name. This becomes a problem when Zendesk then creates a contact for this user as their name is incorrect....

Missing 'Dynamic Data Mapping Structure' references during LAR import due to FieldSet usage in a structure

legacy Troubleshooting

Issue We encountered an error while importing a site from the production environment into the development environment: There are missing references that could not be found in the Live Environment. Please publish again to...

Categories translated to a new language do not show the updated language despite setting the language in Account Settings

legacy Troubleshooting

Issue We've found that when using the 'Multi Column Layout' widget template and setting the Language section on a category filter to French (ex: fr_Fr) it reverts back to 'en_US'. This occurs even when the Account...

Unable to access the REST API from browser with other languages

legacy Troubleshooting

Issue Not able to access Headless API from a browser with different language than the one available in the website. Environment Liferay 2023.q4 Liferay 2024.q1 Resolution This is a known issue and fixed by: LPD-20528...

Embedding videos using basic web content

legacy Troubleshooting

Issue When we try to embed a video using <iframe> tags, during the creation the video displays, however after publishing the content and editing it again, the video is not displayed anymore and the source is updated...

Subscribe option is not shown in Message Boards

legacy Troubleshooting

Issue Subscribe option is not shown in Message Boards even though the Web Site notifications have been configured through My Profile -> Notifications as described here. Environment Liferay 7.4, Quarterly...

Specification Facet is temporarily unavailable

legacy Troubleshooting

Issue Specification Facets are not functioning correctly in certain search scenarios, resulting in the 'Specification Facet is temporarily unavailable' error in the UI and below errors in the Liferay logs. ERROR...

Paginator is not showing intermediate pages in mobile render

legacy Troubleshooting

Issue The default Pagination Taglib Scroll is not showing intermediate pages in PWA mode. Steps to reproduce: 1. Set search.container.page.default.delta=4 in the portal-ext.properties. 2. Start Liferay and create,...

Issue with Asset Publisher Pagination

legacy Troubleshooting

Issue Asset Publisher pagination is not working as expected. The last page is not accurate in the pagination taglib scrollbar in the mobile render as well as the desktop view. Steps to reproduce: Start Liferay and...

A/B Testing - What are the conditions to declare the winner?

legacy Troubleshooting

Issue In conducting A/B testing, all the tests were run in anonymous sessions, ensuring that each session was isolated by closing the incognito tab between tests. I experimented with both anonymous and non-anonymous...

A/B Test data is not displayed on Analytics Cloud

legacy Troubleshooting

Issue After setting up A/B testing for a Liferay instance in Analytics Cloud, the test results do not show up, however, other navigation data is displayed. Environment Analytics Cloud Resolution There are a few...

No item selector views found for ddmuserpersonalfolder

legacy Troubleshooting

Issue A logged in user tries to upload a document through a Form's Upload Field (D&M). When he clicks on the selector it does not open any and an error is shown. You can observe the following warn in the...

Angular custom element Client Extension does not load on SPA navigation

legacy Troubleshooting

Issue Create and deploy an Angular custom element Client Extension, for example: liferay-sample-custom-element-3 . Drag the custom element into a page and navigate with Single Page Application enabled:...

It is not possible to switch between options using Incompatible in Bundle product relations

legacy Troubleshooting

Issue We added two bundle options for a product (i.e. myProduct) and between the products of each option we defined some Incompatible in Bundle product relations. If we open myProduct details and select an option...

DeepL Auto-Translation Error from English (en-US) to German (de-DE)

legacy Troubleshooting

Issue When using the DeepL Translator integration in Liferay 2024q2.0, an error occurs while attempting to auto-translate web content from English (en-US) to German (de-DE), despite German being a supported language in...

Remove Orphan Widgets on Multiple Pages

legacy Troubleshooting

Issue We are running on Liferay 7.4 Q1.7 and we are encountering some issues caused by orphan widgets. I understand that we can delete orphan widgets on a page level but is there any way we can clear orphan widgets for...

Unable to re-enable Analytics Cloud in Production after disabling the connection in a lower environment with Production backup data

legacy Troubleshooting

Issue In a testing scenario in which Production backup data is imported to a lower environment and Analytics Cloud is disabled via the UI in the lower environment, you may observe that the connection gets disabled in...

Search Results