Site Search - Liferay Learn

Upgrading to Elasticsearch 8 7.4 U81+, 7.3 U31+ Elasticsearch 8 is supported and recommended for the latest Liferay DXP Quarterly and Portal GA release out of the box. For specific version...

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

OpenSearch

Official Documentation

OpenSearch Subscription Required Elasticsearch is Liferay's native search engine. Beginning with Liferay DXP 2025.Q1, you can operate Liferay with OpenSearch as the search engine. Refer to the...

Exercise: Run Liferay and OpenSearch Using Docker

Official Documentation

Exercise: Run Liferay and OpenSearch Using Docker Subscription Required Liferay DXP 2025.Q1+ Walk through a minimal Liferay-OpenSearch setup on your local machine to see how a secure HTTPS...

Solr Limitations

Official Documentation

Solr Limitations Liferay's Solr implementation has limitations. Some Liferay features and APIs cannot be used when you choose Solr as the search engine. Install Elasticsearch for the best...

Installing Solr

Official Documentation

Installing Solr 7.2-7.3 (CE, DXP); 7.4 DXP U60+ Solr is a popular enterprise search platform built on Apache Lucene. It's reliable, scalable, and fault tolerant. Read more about it here. Solr is...

Installing OpenSearch

Official Documentation

Installing OpenSearch Subscription Required Liferay DXP 2025.Q1+ You can connect OpenSearch with Liferay. For detailed OpenSearch installation and configuration instructions, consult the...

OpenSearch Connector Configuration Reference

Official Documentation

OpenSearch Connector Configuration Reference Subscription Required Liferay DXP 2025.Q1+ Configure Liferay's connection to OpenSearch with configuration files deployed to Liferay's osgi/configs...

Solr

Official Documentation

Solr Solr is in maintenance mode in Liferay 7.4. Solr Limitations Installing Solr

Elasticsearch Connector Configuration Reference

Official Documentation

Elasticsearch Connector Configuration Reference The configuration information here applies to the latest available (bundled or through Marketplace) version of the Elasticsearch 6 and Elasticsearch...

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

Segmentation By Geolocation

Official Documentation

Segmentation By Geolocation Liferay DXP 7.4 U44+/GA44+ Starting in Liferay DXP 2026.Q1, Segments moves toward a unified experience with Analytics Cloud. The impact depends on your installation...

Migrating User Segments

Official Documentation

Migrating User Segments Starting in Liferay DXP 2026.Q1, Segments moves toward a unified experience with Analytics Cloud. The impact depends on your installation type: Existing Customers: Your...

Personalizing Collections

Official Documentation

Personalizing Collections Liferay Portal 7.3 GA6 / DXP 7.3+ By default, any user can see all the collection's content and is part of the Anyone personalized variation. However, you can create a...

Enabling Automated Live Chat Systems

Official Documentation

Enabling Automated Live Chat Systems Liferay 7.4+ Liferay now offers integration with several live support chat platforms. Enabling this integration adds a chat window to sites on your Liferay...

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

Segments Editor UI Reference

Official Documentation

Segments Editor UI Reference Starting in Liferay DXP 2026.Q1, Segments moves toward a unified experience with Analytics Cloud. The impact depends on your installation type: Existing Customers:...

Migration from Audience Targeting

Official Documentation

Migration from Audience Targeting Starting in Liferay DXP 2026.Q1, Segments moves toward a unified experience with Analytics Cloud. The impact depends on your installation type: Existing...

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

Installing a Search Engine

Official Documentation

Installing a Search Engine A search engine is a critical component of your Liferay installation. Creating an Example Cluster can get you started with the installation, but this guide demonstrates...

Upgrading Search Infrastructure

Official Documentation

Upgrading Search Infrastructure While upgrading Liferay, consider whether an Elasticsearch upgrade is required. The exact steps for upgrading depend on your existing search engine installation and...

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

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

Getting Started

Official Documentation

Getting Started

Manually Migrating from Audience Targeting

Official Documentation

Manually Migrating from Audience Targeting Starting in Liferay DXP 2026.Q1, Segments moves toward a unified experience with Analytics Cloud. The impact depends on your installation type: ...

Experiences

Official Documentation

Experiences Use experience personalization to tailor content pages and collections to different audiences. You can show customized layouts, content, and collection items based on user segments. ...

Search

Official Documentation

Search

Migrating to Segmentation and Personalization

Official Documentation

Migrating to Segmentation and Personalization Starting in Liferay DXP 2026.Q1, Segments moves toward a unified experience with Analytics Cloud. The impact depends on your installation type: ...

Getting Analytics for User Segments

Official Documentation

Getting Analytics for User Segments Subscribers Starting in Liferay DXP 2026.Q1, Segments moves toward a unified experience with Analytics Cloud. The impact depends on your installation type: ...

Segments Admin Settings

Official Documentation

Segments Admin Settings Liferay DXP/Portal 7.3+ Starting in Liferay DXP 2026.Q1, Segments moves toward a unified experience with Analytics Cloud. The impact depends on your installation type: ...

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

Configuring CCR in a Local Follower Data Center

Official Documentation

Configuring CCR in a Local Follower Data Center Subscription [LES Subscription](./deactivating-liferay-enterprise-search.md) First configure CCR in the remote/leader data center before following...

Configuring an Example CCR Installation: Replicating Between Data Centers

Official Documentation

Configuring an Example CCR Installation: Replicating Between Data Centers Subscription [LES Subscription](./deactivating-liferay-enterprise-search.md) This example configures Liferay DXP's...

Liferay Enterprise Search

Official Documentation

Liferay Enterprise Search Subscription LES Subscription Liferay's Enterprise Search (LES) features significantly upgrade the default search capabilities. With a LES subscription you gain the...

Cross Cluster Replication

Official Documentation

Cross Cluster Replication Subscription LES Subscription Cross Cluster Replication Configuring an Example Cross Cluster Replication Installation Configuring a Cross Cluster Replication in a...

Configuring CCR: Settings Reference

Official Documentation

Configuring CCR: Settings Reference Subscription [LES Subscription](./deactivating-liferay-enterprise-search.md) To help with the CCR configuration process, the example configurations from the...

Configuring CCR In a Remote Leader Data Center

Official Documentation

Configuring CCR In a Remote Leader Data Center Subscription [LES Subscription](./deactivating-liferay-enterprise-search.md) Ensure you have completed the necessary prerequisite steps before...

Monitoring Elasticsearch

Official Documentation

Monitoring Elasticsearch Subscription LES Subscription If you have a Liferay Enterprise Search (LES) subscription, you can integrate Elastic's Kibana monitoring UI with Liferay DXP, so your...

Troubleshooting Cross-Cluster Replication

Official Documentation

Troubleshooting Cross-Cluster Replication Subscription [LES Subscription](./deactivating-liferay-enterprise-search.md) Known common pitfalls encountered during the CCR setup are covered here, as...

Cross-Cluster Replication

Official Documentation

Cross-Cluster Replication Subscription [LES Subscription](./deactivating-liferay-enterprise-search.md) In a classic Liferay DXP/search engine installation, one Liferay DXP cluster talks to one...

Deactivating Liferay Enterprise Search

Official Documentation

Deactivating Liferay Enterprise Search Subscription Starting with Liferay DXP 7.4 and in all Enterprise Subscription DXP quarterly releases, the Liferay Enterprise Search (LES) features are...

Learning to Rank

Official Documentation

Learning to Rank Subscription LES Subscription Search engines like Elasticsearch have well-tuned relevance algorithms, good for general search purposes. LES Learning to Rank harnesses machine...

Creating and Managing Elements

Official Documentation

Creating and Managing Elements Elements are one of the fundamental building blocks of Search Blueprints and are managed within the Blueprints application. Open the Global Menu's Applications...

Managing Elements

Official Documentation

Managing Elements To create new Elements, click Add (Add). See Creating Elements for more details. As of Liferay DXP 2023.Q4+/Portal GA102+, the title and description fields are localizable. To...

Search Blueprints

Official Documentation

Search Blueprints Subscription LES Subscription DXP 7.4 U5+; 7.3 U6+ With Search Blueprints you can Make minor tweaks to Liferay's default search page behavior Override the search page...

Collapsing Search Results

Official Documentation

Collapsing Search Results Liferay DXP 2023.Q4+/Portal GA102+ You can collapse search results that have identical keyword field values. For example, an internal blog titled Employee of the Month...

Creating Elements

Official Documentation

Creating Elements There are a lot of system Elements that ship with Search Blueprints. If none of the system Elements meets your needs, there are many ways to create your own Search Blueprints...

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

Collections with Search Blueprints

Official Documentation

Collections with Search Blueprints When you create a search blueprint, you can enable it as a collection provider to display its results. Assets matching the blueprint's query and configuration are...

Creating and Managing Search Blueprints

Official Documentation

Creating and Managing Search Blueprints Create search blueprints to tailor the search experience to your users. You can find the search blueprints application in Global Menu (Global Menu) →...

Personalizing the Search Experience

Official Documentation

Personalizing the Search Experience A premier use case for search blueprints is to personalize Liferay's search results. With a personalized search experience, users see results depending on the...

Predefined Element Variables Reference

Official Documentation

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

Optimizing Search Response Size

Official Documentation

Optimizing Search Response Size In rare cases, an overly large search response can result in ERROR messages from the search engine: ERROR [http-nio-8080-exec-335][ElasticsearchIndexSearcher:165]...

Search Blueprints Elements Reference

Official Documentation

Search Blueprints Elements Reference Elements are one of the fundamental building blocks of a Search Blueprint. To explore all the available Elements, navigate to the Global Menu (Global) →...

Using a Search Blueprint on a Search Page

Official Documentation

Using a Search Blueprint on a Search Page By default, a search page does not have a search blueprint associated with it. A blueprint must be applied to a search page to affect the Liferay search...

Search Blueprints Configuration Reference

Official Documentation

Search Blueprints Configuration Reference The search blueprints user interface has a query builder for creating blueprints. Beyond adding elements and configuring the query settings, there are...

Understanding Search Blueprints

Official Documentation

Understanding Search Blueprints Use search blueprints to tailor the search page experience to your users' needs, without deploying custom code. With blueprints you can Create context-aware...

Sorting Results in a Search Blueprint

Official Documentation

Sorting Results in a Search Blueprint Add a sort configuration to search blueprints to control the order of search results: Open the Global Menu (Global Menu), click the Applications tab, and...

Installing Search Experiences on Liferay 7.3

Official Documentation

Installing Search Experiences on Liferay 7.3 Subscription LES Subscription DXP 7.4 U5+; 7.3 U6+ The Liferay Enterprise Search Experiences app includes a suite of features granting fine-grained...

Creating Picklists

Official Documentation

Creating Picklists Liferay 7.4 U72+/GA72+ Picklists are lists of name/key pairs stored as string values. Once defined, you can use the lists with object definitions to populate single or multiple...