Site Search - Liferay Learn

Limiting the Number of Search Results and Mitigating "Result window is too large." Errors when Using Elasticsearch via index.search.limit and index.max_result_window

Troubleshooting

Every functionality that relies on search engine queries in Liferay can return a maximum of 10,000 results by default. This applies to Search Bar widget searches, search toolbar searches, search REST API usages, and...

Empty searches return no results using a Text Match Over Multiple Fields blueprint element

legacy Troubleshooting

Issue When a Blueprint is configured with the Text Match Over Multiple Fields element, performing an empty search yields no results. Environment Liferay DXP 7.4 U5+ Liferay DXP Quarterly Releases Resolution Text...

How Blueprints Work in Liferay while using Fuzziness?

legacy

Issue How Blueprints Work in Liferay while using Fuzziness? Environment Liferay Quarterly Release Resolution Example case: 1.) Create new environment. 2.) Create new blueprint 3.) Open preview 4.) Add Text...

Running script to import Result Rankings data fails

legacy Troubleshooting

Issue When attempting to run the script from step 2 on Importing the Search Tuning Indexes in 7.4 to import the Result Rankings data, execution fails with the following errors: startup failed: Script1.groovy: 3: unable to...

Hindi Month Names Are Truncated in Search Results

legacy Troubleshooting

Issue After adding the JVM argument -Djava.locale.providers=CLDR, long month names in Hindi get truncated in search results. Example: "सितंबर 07, 2001" to "सितं 07, 2001" Environment Liferay DXP 2023.Q4 Resolution...

Blueprints Display External Reference Codes (ERC)

legacy

Issue After updating Liferay, Blueprints configuration now displays External Reference Codes (ERC) next to the categories, sites and other elements. Environment 2024.Q4+ Resolution This change was implemented in...

Upgrading to a Quarterly Release fails due to Elasticsearch exceptions in the logs

legacy Troubleshooting

Issue When upgrading to a Quarterly Release, coming from an old DXP version, the upgrade fails because of some Elasticsearch errors that can be seen in the logs: ERROR [main][ROOT:47] bundle...

"Elasticsearch node search-1 does not meet the minimum version requirement of 7.16" when updating to u30

legacy Troubleshooting

Issue During our recent update to Update 30, the portal experienced an issue and did not start correctly. The logs show the following error: Elasticsearch node search-1 does not meet the minimum version requirement...

Search Blueprints feature is not shown in Liferay

legacy Troubleshooting

Issue According to this documentation, Search Blueprints, the Search Blueprints functionality is available in DXP 7.3 starting with Update 6. However, after installing DXP 7.3 Update 6, the Search Blueprints...

AssetTagException when using special characters in tag names

legacy

Issue AssetTagException is thrown when the article gets published, in case special characters are used in tag names. 2020-06-23 07:16:18.168 ERROR [http-nio-10.155.2.197-443-exec-4][PortletServlet:112]...

Users Not Appearing in Control Panel After Upgrading Liferay Version

legacy Troubleshooting

Issue Users are not appearing in the Control Panel > Users > Users and Organizations section after upgrading to a newer Liferay version. Environment Liferay DXP 7.0, 7.1 Resolution 1. Remove...

Updating Elasticsearch certificates for x-pack security

legacy Troubleshooting

, knowledgeArticleType: troubleshooting, legacy: true, name: Updating Elasticsearch certificates for x-pack security, showDisclaimerMessage: true, sourceTeam: Support, ticketNumber: 95203, title:...

Team Members are missing from Projects in Customer Portal

legacy Troubleshooting

, knowledgeArticleType: troubleshooting, legacy: true, name: Team Members are missing from Projects in Customer Portal, showDisclaimerMessage: true, sourceTeam: Support, ticketNumber: 86240, title:...

Restringir una búsqueda mediante una query de Elasticsearch y el widget de Filtro personalizado

legacy How To

, knowledgeArticleType: howTo, legacy: true, name: Restringir una búsqueda mediante una query de Elasticsearch y el widget de Filtro personalizado, showDisclaimerMessage: true, sourceTeam: Support, ticketNumber: 39327,...

How do you edit robots.txt for virtual host public pages?

legacy Troubleshooting

Issue We are trying to edit the robots.txt file through public pages, but we are getting the following message: 'Please set the virtual host before you set the robots.txt'. We are using one instance with two sites and...

"module java.base does not 'opens java.lang.invoke'" Error Prevents Elasticsearch Sidecar Startup

legacy Troubleshooting

Issue I'm unable to get the Elasticsearch Sidecar to start after upgrading to a quarterly release of Liferay DXP. When checking the server logs, I see the following error message:...

Last Login Date is not updated in the User's and Organizations Menu

legacy Troubleshooting

Issue The Last Login Date displayed in the Users and Organizations UI is not updating accurately. Even after a user logs in, the date remains unchanged. Environment Liferay DXP 2024.Q4+ Resolution Enable Feature...

In the Documents and Media portlet, the search is not performed on the selected folder in its configuration

legacy Troubleshooting

Issue I have an issue with the documents and media portlet document search. I have two document folders and two document and media portlets on a page. One folder is set at a document folder, the other is set at another...

Search navigation not showing the correct pagination or displaying the last couple of Web Content documents

legacy Troubleshooting

Issue When using the search navigation, we've discovered that not all of the web contents are displayed. The pagination is also not reflecting the correct amount of web content documents. Steps to reproduce: 1. Start...

Incorrect Pagination Behavior in the SearchResultsPortlet

legacy Troubleshooting

Issue I have an issue with the search results portlet pagination. When searching for an item by selecting a page after page 20, the first page results are shown instead of the selected page. Steps to reproduce: Set up...

Pages Appear in Search Results But Lead to 404 Errors

legacy Troubleshooting

Issue Some search results lead to 404 pages, even after reindexing. Pages exist but cannot be navigated to with the search bar. Search bar is unresponsive when clicking on certain results. Environment...

Sites/Groups Not Searchable in Out-of-the-Box Liferay

legacy

Issue We do not see sites as an option while selecting different asset types in the Type Facet portlet as well as in Blueprint configuration. However, we can see in the Liferay source code that SiteAssetRendererFactory...

Indexed documents are removed after full reindex with LPS-152937

legacy Troubleshooting

, knowledgeArticleType: troubleshooting, legacy: true, name: Indexed documents are removed after full reindex with LPS-152937, showDisclaimerMessage: true, sourceTeam: Support, ticketNumber: 109834,...

Commerce product specification values (and translations of the values) are searched by taking into account the instance/site default language, not the user display language

legacy Troubleshooting

, knowledgeArticleType: troubleshooting, legacy: true, name: Commerce product specification values (and translations of the values) are searched by taking into account the instance/site default language, not the user...

Where to find Liferay Connector for Elasticsearch 7 for Liferay DXP 7.2

legacy How To

, knowledgeArticleType: howTo, legacy: true, name: Where to find Liferay Connector for Elasticsearch 7 for Liferay DXP 7.2, showDisclaimerMessage: true, sourceTeam: Support, ticketNumber: 82332, title: Liferay DXP...

Flood stage disk watermark [95%] exceeded

legacy Troubleshooting

, knowledgeArticleType: troubleshooting, legacy: true, name: Flood stage disk watermark [95%] exceeded, showDisclaimerMessage: true, sourceTeam: Support, ticketNumber: , title: フラッドステージディスクウォーターマーク [95%]...

Elasticsearch exception no mapping found para los campos spellCheckWord_es_ES o spellCheckWord_en_US

legacy

, knowledgeArticleType: troubleshooting, legacy: true, name: Elasticsearch exception no mapping found para los campos spellCheckWord_es_ES o spellCheckWord_en_US, showDisclaimerMessage: true, sourceTeam: Support,...

Search

Official Documentation

Search You can use the search page to find content available on a Liferay site. This can be web content, knowledge base articles, documents, images, products, etc. The search page contains a search...

Search APIs

Official Documentation

Search APIs Generally Available in Liferay DXP 2025.Q4+/Portal 2026.Q1+ You can search with headless APIs using the endpoints at /o/search. These are the primary endpoints: Use the GET /search...

Search Suggestions API

Official Documentation

Search Suggestions API DXP 7.4 U36+/Portal GA36+ You can return suggestions using the /suggestions headless API. This API is used by Liferay's Search Bar Suggestions feature. There are two primary...

Search API Basics

Official Documentation

Search API Basics Generally Available in Liferay DXP 2025.Q4+/Portal 2026.Q1+ You can search for content from a Liferay search page, but you can also use the /search API endpoints. If you're...

Contributing Custom Content to the Similar Results Widget

Official Documentation

Contributing Custom Content to the Similar Results Widget Subscribers This functionality relies on a Service Provider Interface (SPI) that's bundled with Liferay DXP 7.3+. It's available in...

Search Queries and Filters

Official Documentation

Search Queries and Filters To get sensible results from the search engine, you must provide a sensible query. Liferay's query APIs are in the portal-search-api module and are used to construct both...

Search

Official Documentation

Search

Developer Guide

Official Documentation

Developer Guide Contributing Custom Content to the Similar Results Widget Search Queries and Filters Aggregations Model Entity Indexing APIs Search Headless APIs

Getting Started

Official Documentation

Getting Started

Advanced Configuration of the Liferay Elasticsearch Connector

Official Documentation

Advanced Configuration of the Liferay Elasticsearch Connector The Elasticsearch connection is configured using a configuration file or via System Settings. The Elasticsearch connector has a lot of...

Search Overview

Official Documentation

Search Overview Search is a fundamental component of Liferay. Elasticsearch is bundled with Liferay for testing and development purposes. Production environments require Elasticsearch running on a...

Installing and Upgrading a Search Engine

Official Documentation

Installing and Upgrading a Search Engine A search engine is a critical component of your Liferay installation. Creating an Example Cluster can get you started with an Elasticsearch installation,...

Searching for Content

Official Documentation

Searching for Content All indexed content (a.k.a. assets in Liferay DXP) can be returned as search results. Custom content can also be indexed, so your installation might have additional asset...