Site Search - Liferay Learn

What's New in Search for 7.3? Elasticsearch Integration Elasticsearch 7 Support Liferay CE 7.3 GA4+, Liferay DXP 7.3 GA1+ Liferay DXP 7.3 comes with out-of-the-box support for Elasticsearch 7. The...

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

Elasticsearch

Official Documentation

Elasticsearch Elasticsearch is the highly scalable, full-text search engine Liferay uses by default. Elasticsearch is bundled with Liferay for non-production purposes. In production, Liferay...

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

Connecting to Elasticsearch

Official Documentation

Connecting to Elasticsearch After setting up Elasticsearch, connect it to Liferay using the Liferay Connector to Elasticsearch. Connection steps depend on the connector you're configuring. See...

Exercise: Run Liferay and Elasticsearch Using Docker

Official Documentation

Exercise: Run Liferay and Elasticsearch Using Docker Liferay 7.3+ Here you can walk through a minimal Liferay-Elasticsearch setup on your local machine to see how a secure REST Client connection...

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

Troubleshooting Elasticsearch: Common Issues

Official Documentation

Troubleshooting Elasticsearch: Common Issues Listed here are some common issues you may encounter while configuring Elasticsearch and Liferay. Additional connection-specific errors are discussed in...

Troubleshooting Elasticsearch Installation

Official Documentation

Troubleshooting Elasticsearch Installation Liferay and Elasticsearch are complex systems full of configurations. When connecting them, you can run into difficulty along the way. Included below are...

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 Elasticsearch

Official Documentation

Upgrading Elasticsearch Liferay supports Elasticsearch 8. The compatibility matrix provides the latest support details. Elasticsearch 6.x is not supported on Liferay 7.3+. Before planning your...

Upgrading to Elasticsearch 8

Official Documentation

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

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

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

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