Site Search - Liferay Learn

Predefined Element Variables Reference In the Element Source editor, place the cursor in the desired location and click the variable in the left hand sidebar to insert it. In the Custom JSON...

Creating and Managing Search Blueprints

Official Documentation

Creating and Managing Search Blueprints You can create Search Blueprints from the Global menu's Applications section → Search Experiences. If you already have a Blueprint and want to apply it's...

Installing OpenSearch

Official Documentation

Installing OpenSearch Subscription Required [Beta Feature](../../../security-and-administration/administration/configuring-liferay/feature-flags.md) You can connect OpenSearch with Liferay. For...

OpenSearch Connector Configuration Reference

Official Documentation

OpenSearch Connector Configuration Reference Subscription Required [Beta Feature](../../../security-and-administration/administration/configuring-liferay/feature-flags.md) Configure Liferay's...

OpenSearch

Official Documentation

OpenSearch Subscription Required [Beta Feature](../../security-and-administration/administration/configuring-liferay/feature-flags.md) Elasticsearch is Liferay's native search engine. Beginning...

Custom Element Examples

Official Documentation

Custom Element Examples Here are example elements that use custom fields and nested fields in their contributed query clauses. Using Custom Fields (Expando) in Elements You can add custom fields...

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

Getting Started with Elasticsearch

Official Documentation

Getting Started with Elasticsearch Compatibility: See the Search Engine Compatibility Matrix for details on the compatible Elasticsearch versions, available Liferay connectors, and required...

Installing Elasticsearch

Official Documentation

Installing Elasticsearch Here's how to install, configure, and start Elasticsearch on-premises. If you have Elasticsearch indexes used for primary data storage (storing data not backed by a...

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

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

Troubleshooting the Elasticsearch Connection

Official Documentation

Troubleshooting the Elasticsearch Connection Listed here are some connection issues you can encounter when configuring the Liferay-Elasticsearch connection, along with the most common solutions to...

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

Backing Up Elasticsearch

Official Documentation

Backing Up Elasticsearch Elasticsearch replicas protect against a node going down, but they won't help you with a catastrophic failure. Only good backup practices can help you then. Backing Up...

Securing Elasticsearch

Official Documentation

Securing Elasticsearch The very first thing you must do to secure Elasticsearch is enable X-Pack Security. After that you can begin configuring authentication and encrypted communication. ...

Upgrading to Elasticsearch 7

Official Documentation

Upgrading to Elasticsearch 7 7.1 and 7.2 Liferay's connection to Elasticsearch 7.17.x servers is deprecated due to the End of Life for Elasticsearch 7.17. Connecting to a deprecated Elasticsearch...

Using the Sidecar or Embedded Elasticsearch

Official Documentation

Using the Sidecar or Embedded Elasticsearch Sidecar and embedded Elasticsearch are not suitable for production. When using an app server different other than Tomcat, set up a standalone...

Deactivating Liferay Enterprise Search

Official Documentation

Deactivating Liferay Enterprise Search Starting with Liferay DXP 7.4 and in all quarterly releases, the Liferay Enterprise Search (LES) features are included out-of-the-box. You can begin using LES...

Cross Cluster Replication

Official Documentation

Cross Cluster Replication Cross Cluster Replication Configuring an Example Cross Cluster Replication Installation Configuring a Cross Cluster Replication in a Remote Leader Data Center ...

Elasticsearch Indexes Reference

Official Documentation

Elasticsearch Indexes Reference Liferay 7.3 and 7.4 each have a set of indexes created in Elasticsearch. Understanding these indexes and what they do can help you better configure and administer...

Exploring Indexed Fields

Official Documentation

Exploring Indexed Fields Some search features can be configured if you know how to explore a search document's fields or inspect the search engine's field mappings. The available index fields can...

Configuring Search Bar Suggestions

Official Documentation

Configuring Search Bar Suggestions 7.4 U36+ and GA36+ Search Bar Suggestions adds search as you type functionality to Liferay's Search Bar widget. Select a result from the drop-down list or...

Category Facet

Official Documentation

Category Facet The Category Facet narrows search results for categorized assets that match the search query keywords. Each matching result's categories are aggregated as facet terms. Example of...

Custom Filter Examples

Official Documentation

Custom Filter Examples This feature does not work with Solr. The Custom Filter widget is a powerful aid to your search tuning efforts. Without deploying custom code, you can exert control over...

Custom Facet Examples

Official Documentation

Custom Facet Examples The custom facet is a powerful aid to customizing your site's search experience. When the out-of-the-box facets don't meet your requirements, the custom facet fills the gap....

Configuring the Search Results Widget

Official Documentation

Configuring the Search Results Widget Configure the Search Results widget by opening its options menu (Options) and selecting Configuration. The display of Search Results is configured in the...

Search Results Widget Template Reference

Official Documentation

Search Results Widget Template Reference While creating a search results widget template, you can access pre-populated variables in the FreeMarker template editor. The variables listed in the...

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

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

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

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

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

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

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

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