Site Search - Liferay Learn

SAML Logout Issues: Multiple Login Entries and Optimistic Locking Exceptions

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

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

Some result searches for the same document can show text with replacement characters (�)

legacy Troubleshooting

Issue A text document (such as a PDF) has been added to the document library. Searching by a piece of text in the file, the result includes an excerpt with regular text including the search string. Searching by a...

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

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

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

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

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

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

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

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

CORS request is failing

legacy Troubleshooting

Issue If the user allows any origin (Access-Control-Allow-Origin: *) to access the resource, the CORS request fails. Steps to reproduce: 1. Start Liferay DXP 7.4 U90 2. Navigate to Control Panel > Instance...

S3 Requests Causing Timeouts in Environments Without Internet Access

legacy Troubleshooting

Issue We observe very long loading times (over 60 seconds) when accessing certain content management pages in the admin area, particularly: Editing a page in the page editor for the first time after login...

Sitemap does not show the complete page tree

legacy Troubleshooting

Issue Using following URL http://my-domain/sitemap.xml does not show the complete page tree. What should we take into account for all pages are included in sitemap? Environment 2024.Q1.10 Resolution When you...

Rest API filter by custom expando field: A property used in the filter criteria is not supported

legacy Troubleshooting

Issue How do I filter accounts by custom field with Rest APi? I'm on 2024.q3.9, fp3, and I have added a custom field to account (From Control Panel --> Custom Fields --> Account Entry) Name: Foo Key: foo Data type: text...

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

I want to skip OpenID Connect provider selector at sign in if there is only one provider

legacy Troubleshooting

Issue We want to bypass the client selection screen because there is only one OpenID Client to choose. Environment Quarterly Releases Resolution There is a Feature Request opened for this which is currently under...

Getting invalid checksum error when building the Liferay Workspace

legacy Troubleshooting

Issue Facing an error when attempting to initialize a Liferay DXP bundle in the user's Liferay workspace. Steps to reproduce: 1. Create a Liferay workspace project. 2. Set the following in gradle.properties:...

Liferay Learn Resources Taglib

legacy Troubleshooting

Issue In recent versions of Liferay, the liferay-learn taglib has been introduced to automatically include links to the official Liferay Learn documentation. This functionality is controlled by the...

Unable to see the add button to create a new language override key

legacy Troubleshooting

Issue When create a new user and assigning that user to a newly created regular role, then the add button to create a language override key is not visible to that user. Steps to reproduce: 1. Navigate to Control...

Problem with Web content structure field reference

legacy Troubleshooting

Issue Reproduction steps: 1. Create a structure "test-structure" -> add single selection field. 2. Edit the field options and corresponding field references -> Option1 (field reference: "true") and option2...

Workflow is not triggered for hidden content pages

legacy Troubleshooting

Issue Trigger workflow for hidden content pages is not working Steps to Reproduce: 1) Navigate to Site Menu > Site Builder > Pages 2) Add a blank 3) Navigate to page configuration, set 'Hidden from Navigation Menu...

Product details widget

legacy Troubleshooting

Issue The product details widget is not showing the related tabs (e.g. Full Description, Replacements, Attachments, Specifications, etc.) Environment Liferay DXP 7.4 Commerce 4.0 Resolution The observed behavior...

Fragments are no longer accessible due to deleted users

legacy Troubleshooting

Issue The user creates a User with the Administrator role, then impersonates the User and adds a fragment collection to the Global Site. They then deactivate and delete the user. They attempt to create a fragment...

Unable to create directory error

legacy Troubleshooting

Issue The following error appears in the console: ERROR [Start Level: Equinox Container: 10106855-d66b-001d-184e-d6958ecd00e8][comliferayportalstorefilesystem:97]...

"cannot execute SELECT FOR UPDATE in a read-only transaction" error while logging in portal

legacy Troubleshooting

Issue Below error observed in logs and UI(internal serve error) while logging in to the portal: 2022-11-22 10:41:23.108 ERROR[http-nio-8080-exec-16][JDBCExceptionReporter:234]ERROR: cannot execute SELECT FOR UPDATE in...

Why there is no "Link to page" element when mapping it on a fragment?

legacy Troubleshooting

Issue When we include a "Link to page" field into a structure and we are attempting to map it on a fragment, the "Link to page" field is missing from the list. Environment Liferay DXP 7.1+ Resolution This is...

Workflow cannot be used with Publications enabled, and vice versa

legacy Troubleshooting

Issue When we enable Workflow and Publications together, and we can't publish assets, e.g. web content articles We see the below exceptions in the log: ERROR...

Link doesn't work in Knowledge base when a non-standard protocol is chosen.

legacy Troubleshooting

Issue When adding the notes:// protocol to a link in Knowledge Base, AntiSamy removes it and displays it as text. Environment Liferay DXP 7.2, 7.3 Resolution By default, everything is sanitized by AntiSamy, with 3...

How to turn on Debug logging for Patching tool?

legacy Troubleshooting

Issue When we have any kind of issues while using Patching Tool, we can't analyze the problem because we see the same information in the log and in the console too: The command has failed. Please see the log for...

Roles Admin portlet should not display permissions for Instance Settings and App Manager portlets

legacy Troubleshooting

Issue Reproduction Steps 1. Add a Regular Role "Role A", and grant this role the following permission App Manager: Access in Control Panel App Manager: Configuration App Manager: Permissions App Manager: Preferences...

Sorting search results by a localizable structure field is wrong when viewing the page in different languages

legacy Troubleshooting

Issue When using the Search Sort widget to order the search results by a structure field, it results in different ordering when viewing the page in different languages. The selected structure field is...

Can Users share blogs with emails that are not associated with an internal user?

legacy Troubleshooting

Issue Are internal users able to send these Share Emails to external users? Steps to reproduce: 1) Start a clean bundle of DXP 7.3 2) Set up an SMTP server and connect it with Liferay and verify that email...

' Done button' in the select dialog popup window is not keyboard accessible by pressing Enter key

legacy Troubleshooting

Issue When the 'Done' button is highlighted by the screen reader and 'Enter' is pressed on the keyboard the button is not activated, and nothing happens Steps to reproduce: 1) Content Data > Documents and Media 2)...

Spellcheck Suggestions retain all original words

legacy Troubleshooting

Issue Reindex all spell check indexes (Control Panel > Search > Reindex all spell check indexes) Create a Basic Web Content with title: Leave out the cash Publish Open the default search...

The screen name cannot be an email address or a reserved word

legacy Troubleshooting

Issue When trying to log in with an Active Directory user, sign-in failed with the below error ERROR [http-nio-8080-exec-9][BaseSamlStrutsAction:59] Screen name test@liferay.com for user 34945 must validate...

Unable to set display page templates for Global Structures in a sub site

legacy Troubleshooting

Issue Since Default Values are not site-scoped, but always share the scope of their Structure, and because Global Structures can't have Display Pages set because there are no pages on the Global site, Global...

The Structure field is rendered incorrectly on template page

legacy Troubleshooting

Issue When the content of a fragment 'select from list' is mapped as a field in a display page template or content page, the rendering contains unexpected characters. Steps to reproduce: 1) Set up a clean instance...

The friendly URL for Web Content is generated without any clean special characters, dots, or slashes

legacy Troubleshooting

Issue When a user creates web content with dots '.', the friendly URL shows the dot. Unlike other special characters such as Spaces, the dot is not replaced. Steps to reproduce: 1. Start the DXP 7.3 2. Navigate to...

Search Results