Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
31 commits
Select commit Hold shift + click to select a range
c70c2d5
Move Elasticsearch solution files to new directory
leemthompo Dec 8, 2025
ef803d9
Add Elasticsearch solution and Search use case overview pages
leemthompo Dec 8, 2025
597e532
Update Search pages to reference Elasticsearch solution
leemthompo Dec 8, 2025
45e407b
Update ES solution get-started page with new content
leemthompo Dec 8, 2025
6a5fb4b
Restructure navigation into Search use case and Elasticsearch solution
leemthompo Dec 8, 2025
2efdd52
Fix toc.yml to remove non-existent quickstart references
leemthompo Dec 8, 2025
a561b33
Fix internal references and redirects after file moves
leemthompo Dec 8, 2025
31d7bfe
Update all internal references to moved pages
leemthompo Dec 8, 2025
b67429e
Update remaining references to playground, MCP, and search-applications
leemthompo Dec 8, 2025
460e69c
Fix final search-with-synonyms reference in ece-ha.md
leemthompo Dec 8, 2025
c94e778
Move search-connection-details to Elasticsearch solution
leemthompo Dec 8, 2025
168f2d9
Improve Search use case landing page
leemthompo Dec 8, 2025
490f92f
Move synonyms documentation to Search use case
leemthompo Dec 9, 2025
ae00cdf
Add redirects for ES solution pages moved from Search
leemthompo Dec 9, 2025
cb7669a
Fix broken links with absolute paths
leemthompo Dec 9, 2025
369a369
Restore stepper format to Elasticsearch solution get-started page
leemthompo Dec 10, 2025
0a97210
delete temp file
leemthompo Dec 10, 2025
1b59a93
tweak verbiage
leemthompo Dec 10, 2025
0e687bf
refactor the solutions-use-cases landing page
leemthompo Dec 10, 2025
1be8f3f
less repetition
leemthompo Dec 10, 2025
817c0b2
tighten up
leemthompo Dec 10, 2025
ae1a361
de-emphasize search applications
leemthompo Dec 10, 2025
471b254
clarify verbiage
leemthompo Dec 10, 2025
752a53e
better words
leemthompo Dec 10, 2025
3893f33
rework use case landing page
leemthompo Dec 10, 2025
58db21a
update related links
leemthompo Dec 10, 2025
45f2b62
reword
leemthompo Dec 10, 2025
60583fc
restore better wording
leemthompo Dec 10, 2025
be72056
fix table
leemthompo Dec 10, 2025
337360f
Apply suggestions
leemthompo Dec 11, 2025
35db040
Merge branch 'main' into leemthompo/searchy-mc-elasticsearch
leemthompo Dec 11, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion deploy-manage/deploy/cloud-enterprise/ece-ha.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ Backing up Zookeeper data directory is also recommended. Refer to [rebuilding a

## External resources accessibility

If youre using a [private Docker registry server](ece-install-offline-with-registry.md) or hosting any [custom bundles and plugins](../../../solutions/search/full-text/search-with-synonyms.md) on a web server, make sure these resources are accessible from all ECE allocators, so they can continue to be accessed in the event of a network partition or zone outage.
If you're using a [private Docker registry server](ece-install-offline-with-registry.md) or hosting any [custom bundles and plugins](/solutions/search/full-text/search-with-synonyms.md) on a web server, make sure these resources are accessible from all ECE allocators, so they can continue to be accessed in the event of a network partition or zone outage.

## Other recommendations

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -98,7 +98,7 @@ This table compares Elasticsearch capabilities between {{ech}} deployments and S
| **Repository management** | ✅ | Managed | Automatically managed by Elastic |
| [**Scripted metric aggregations**](elasticsearch://reference/aggregations/search-aggregations-metrics-scripted-metric-aggregation.md) | ✅ | ❌ | Not available in Serverless<br>The alternative for this in Serverless is [ES|QL](elasticsearch://reference/query-languages/esql.md) |
| [**`join` fields**](elasticsearch://reference/elasticsearch/mapping-reference/parent-join.md) | ✅ | ❌ | Not available in Serverless<br>The alternative for this in Serverless is the ES\|QL [`LOOKUP JOIN`](elasticsearch://reference/query-languages/esql/commands/lookup-join.md) command |
| [**Search applications**](/solutions/search/search-applications.md) | - UI and APIs <br>- Maintenance mode (beta) | - API-only <br>- Maintenance mode (beta) | UI not available in Serverless |
| [**Search applications**](/solutions/elasticsearch-solution-project/search-applications.md) | - UI and APIs <br>- Maintenance mode (beta) | - API-only <br>- Maintenance mode (beta) | UI not available in Serverless |
| **Shard management** | User-configurable | Managed by Elastic | No manual shard allocation in Serverless |
| [**Watcher**](/explore-analyze/alerts-cases/watcher.md) | ✅ | ❌ | Use **Kibana Alerts** instead, which provides rich integrations across use cases |
| **Web crawler** | ❌ (Managed Elastic Crawler discontinued with Enterprise Search in 9.0) | Self-managed only | Use [**self-managed crawler**](https://github.com/elastic/crawler) |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -49,4 +49,4 @@ For more detailed information about the `start-local` setup, refer to the [READM

## Next steps [local-dev-next-steps]

Use our [quick start guides](/solutions/search/get-started/quickstarts.md) to learn the basics of {{es}}.
Use our [quick start guides](/solutions/elasticsearch-solution-project/get-started/quickstarts.md) to learn the basics of {{es}}.
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ This Hot/Frozen – High Availability architecture is intended for organizations
* Have a requirement for cost effective long term data storage (many months or years).
* Provide insights and alerts using logs, metrics, traces, or various event types to ensure optimal performance and quick issue resolution for applications.
* Apply [machine learning anomaly detection](/explore-analyze/machine-learning/anomaly-detection.md) to help detect patterns in time series data to find root cause and resolve problems faster.
* Use an AI assistant ([Observability](/explore-analyze/ai-features/ai-assistant.md), [Security](/solutions/security/ai/ai-assistant.md), or [Playground](/solutions/search/rag/playground.md)) for investigation, incident response, reporting, query generation, or query conversion from other languages using natural language.
* Use an AI assistant ([Observability](/explore-analyze/ai-features/ai-assistant.md), [Security](/solutions/security/ai/ai-assistant.md), or [Playground](/solutions/elasticsearch-solution-project/playground.md)) for investigation, incident response, reporting, query generation, or query conversion from other languages using natural language.
* Deploy an architecture model that allows for maximum flexibility between storage cost and performance.

::::{important}
Expand Down
6 changes: 3 additions & 3 deletions explore-analyze/ai-features.md
Original file line number Diff line number Diff line change
Expand Up @@ -71,19 +71,19 @@ The [{{es}}](/solutions/search.md) solution view (or project type in {{serverles

### Agent Builder

[Agent Builder](/solutions/search/elastic-agent-builder.md) enables you to create AI agents that can interact with your {{es}} data, run queries, and provide intelligent responses. It provides a complete framework for building conversational AI experiences on top of your search infrastructure.
[Agent Builder](/solutions/elasticsearch-solution-project/elastic-agent-builder.md) enables you to create AI agents that can interact with your {{es}} data, run queries, and provide intelligent responses. It provides a complete framework for building conversational AI experiences on top of your search infrastructure.

### AI assistant for {{es}}

[](/solutions/observability/observability-ai-assistant.md) helps you understand, analyze, and interact with your Elastic data throughout {{kib}}. It provides a chat interface where you can ask questions about the {{stack}} and your data, and provides contextual insights throughout {{kib}} that explain errors and messages and suggest remediation steps.

### Playground

[Playground](/solutions/search/rag/playground.md) enables you to use large language models (LLMs) to understand, explore, and analyze your {{es}} data using retrieval augmented generation (RAG), via a chat interface. Playground is also very useful for testing and debugging your {{es}} queries, using the [retrievers](/solutions/search/retrievers-overview.md) syntax with the `_search` endpoint.
[Playground](/solutions/elasticsearch-solution-project/playground.md) enables you to use large language models (LLMs) to understand, explore, and analyze your {{es}} data using retrieval augmented generation (RAG), via a chat interface. Playground is also very useful for testing and debugging your {{es}} queries, using the [retrievers](/solutions/search/retrievers-overview.md) syntax with the `_search` endpoint.

### Model context protocol

The [Model Context Protocol (MCP)](/solutions/search/mcp.md) lets you connect AI agents and assistants to your {{es}} data to enable natural language interactions with your indices.
The [Model Context Protocol (MCP)](/solutions/elasticsearch-solution-project/mcp.md) lets you connect AI agents and assistants to your {{es}} data to enable natural language interactions with your indices.

## AI-powered features in {{observability}}

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ This feature is not available at all Elastic subscription levels. Refer to the E

### ELSER text expansion [ingest-pipeline-search-inference-elser]

Using Elastics [ELSER machine learning model](../nlp/ml-nlp-elser.md) you can easily incorporate text expansion for your queries. This works by using ELSER to provide semantic enrichments to your documents upon ingestion, combined with the power of [Elastic Search Application templates](../../../solutions/search/search-applications.md) to provide automated text expansion at query time.
Using Elastic's [ELSER machine learning model](../nlp/ml-nlp-elser.md) you can easily incorporate text expansion for your queries. This works by using ELSER to provide semantic enrichments to your documents upon ingestion, combined with the power of [Elastic Search Application templates](/solutions/elasticsearch-solution-project/search-applications.md) to provide automated text expansion at query time.

### Named entity recognition (NER) [ingest-pipeline-search-inference-ner]

Expand Down
2 changes: 1 addition & 1 deletion explore-analyze/query-filter.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ You’ll use a combination of an API endpoint and a query language to interact w

- A number of [tools](/explore-analyze/query-filter/tools.md) are available for you to save, debug, and optimize your queries.

If you're just getting started with {{es}}, try the hands-on [](/solutions/search/get-started/index-basics.md) to learn how to add data and run basic searches using Query DSL and the `_search` endpoint.
If you're just getting started with {{es}}, try the hands-on [](/solutions/elasticsearch-solution-project/get-started/index-basics.md) to learn how to add data and run basic searches using Query DSL and the `_search` endpoint.

## Filtering

Expand Down
2 changes: 1 addition & 1 deletion explore-analyze/query-filter/tools/playground.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,6 @@ Use the Search Playground to test and edit {{es}} queries visually in the UI. Th
Find Playground in the {{es-serverless}} UI under **{{es}} > Build > Playground**.

::::{note}
ℹ️ For more details, check the full [Playground documentation](../../../solutions/search/rag/playground.md).
ℹ️ For more details, check the full [Playground documentation](/solutions/elasticsearch-solution-project/playground.md).

::::
16 changes: 13 additions & 3 deletions redirects.yml
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

assuming that this list of redirects is currently incomplete

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

correct

Original file line number Diff line number Diff line change
@@ -1,4 +1,14 @@
redirects:
# Search primitives moved from ES solution to Search use case
'solutions/elasticsearch-solution-project/full-text/search-with-synonyms.md': 'solutions/search/full-text/search-with-synonyms.md'
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't see this page being moved in this pr

'solutions/elasticsearch-solution-project/full-text/create-update-synonyms-api-example.md': 'solutions/search/full-text/create-update-synonyms-api-example.md'
# ES solution pages moved from Search to ES solution
'solutions/search/agent-builder/get-started.md': 'solutions/elasticsearch-solution-project/agent-builder/get-started.md'
'solutions/search/elastic-agent-builder.md': 'solutions/elasticsearch-solution-project/elastic-agent-builder.md'
'solutions/search/query-rules-ui.md': 'solutions/elasticsearch-solution-project/query-rules-ui.md'
'solutions/search/search-applications.md': 'solutions/elasticsearch-solution-project/search-applications.md'
'solutions/search/search-applications/search-application-client.md': 'solutions/elasticsearch-solution-project/search-applications/search-application-client.md'
'solutions/search/search-connection-details.md': 'solutions/elasticsearch-solution-project/search-connection-details.md'
'deploy-manage/security/secure-http-communications.md': '!deploy-manage/security/secure-cluster-communications.md'
'deploy-manage/security/manually-configure-security-in-self-managed-cluster.md': '!deploy-manage/security/self-setup.md'
'deploy-manage/security/security-certificates-keys.md': '!deploy-manage/security/self-auto-setup.md'
Expand Down Expand Up @@ -326,13 +336,13 @@ redirects:
'deploy-manage/monitor/autoops/ec-autoops-dismiss-event.md': 'deploy-manage/monitor/autoops/ec-autoops-events.md'

# Related to https://github.com/elastic/docs-content/pull/2245/
'solutions/search/elasticsearch-basics-quickstart.md': 'solutions/search/get-started/index-basics.md'
'solutions/search/elasticsearch-basics-quickstart.md': 'solutions/elasticsearch-solution-project/get-started/index-basics.md'

# Related to https://github.com/elastic/elasticsearch/pull/133362
'solutions/search/querydsl-full-text-filter-tutorial.md': 'elasticsearch://reference/query-languages/query-dsl/full-text-filter-tutorial.md'

# Related to https://github.com/elastic/docs-content/pull/2719
'solutions/search/api-quickstarts.md': 'solutions/search/get-started/quickstarts.md'
'solutions/search/api-quickstarts.md': 'solutions/elasticsearch-solution-project/get-started/quickstarts.md'

# Related to https://github.com/elastic/docs-content/pull/2745
'solutions/search/run-elasticsearch-locally.md': 'deploy-manage/deploy/self-managed/local-development-installation-quickstart.md'
Expand All @@ -355,7 +365,7 @@ redirects:
'troubleshoot/observability/apm-agent-swift/apm-ios-agent.md': 'troubleshoot/ingest/opentelemetry/edot-sdks/ios/index.md'

# Related to https://github.com/elastic/docs-content/pull/2843
'solutions/search/serverless-elasticsearch-get-started.md': 'solutions/search/get-started.md'
'solutions/search/serverless-elasticsearch-get-started.md': 'solutions/elasticsearch-solution-project/get-started.md'

# Related to https://github.com/elastic/docs-content/pull/3032
'manage-data/lifecycle/index-lifecycle-management/tutorial-automate-rollover.md': 'manage-data/lifecycle/index-lifecycle-management/ilm-tutorials.md'
Expand Down
2 changes: 1 addition & 1 deletion reference/elasticsearch-clients/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,5 +22,5 @@ products:
- [Rust](elasticsearch-rs://reference/index.md)

::::{tip}
Learn how to [connect to your {{es}} endpoint](/solutions/search/search-connection-details.md).
Learn how to [connect to your {{es}} endpoint](/solutions/elasticsearch-solution-project/search-connection-details.md).
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

do we care to tell people how to connect to these in other contexts, if we can assume that clients are solution-agnostic? probably a problem for later

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

good q not sure, need to check what the experience is like on other project types too + if we should have a raw non-UI section for connection details

::::
2 changes: 1 addition & 1 deletion release-notes/elastic-cloud-serverless/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -427,7 +427,7 @@ Review the changes, fixes, and more to {{serverless-full}}.

### Features and enhancements [serverless-changelog-10202025-features-enhancements]

* [Agent Builder](/solutions/search/elastic-agent-builder.md) is now available in technical preview and is enabled by default on {{serverless-full}}
* [Agent Builder](/solutions/elasticsearch-solution-project/elastic-agent-builder.md) is now available in technical preview and is enabled by default on {{serverless-full}}
* Lets you remove root privileges from {{fleet}} managed agents [#237790]({{kib-pull}}237790)
* Adds the `xpack.fleet.experimentalFeatures` setting [#238840]({{kib-pull}}238840)
* Supports expression suggestions within function parameters [#236343]({{kib-pull}}236343)
Expand Down
68 changes: 68 additions & 0 deletions solutions/elasticsearch-solution-project.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
---
mapped_pages:
- https://www.elastic.co/guide/en/serverless/current/what-is-elasticsearch-serverless.html
- https://www.elastic.co/guide/en/kibana/current/search-space.html
applies_to:
stack:
serverless:
products:
- id: elasticsearch
- id: cloud-serverless
- id: kibana
navigation_title: Elasticsearch solution
---

# {{es}} solution & project type overview

::::{tip}
Not sure which deployment type is right for you? Use the following resources to help you decide:

- Read the Elastic [deployment types overview](/deploy-manage/deploy.md)
- Compare [serverless and {{ech}}](/deploy-manage/deploy/elastic-cloud/differences-from-other-elasticsearch-offerings.md)
- Compare pricing models between [Elastic Cloud](/deploy-manage/cloud-organization/billing/cloud-hosted-deployment-billing-dimensions.md) and [Serverless](/deploy-manage/cloud-organization/billing/serverless-project-billing-dimensions.md)
::::


The {{es}} solution and serverless project type provide specialized UI tools and interfaces that help you build search applications on top of the {{es}} platform.

These UI affordances are exclusive to the {{es}} **solution** (on non-serverless deployments) and the {{es}} serverless **project type**. They complement the core [search primitives](/solutions/search.md) available across all Elastic deployments.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

maybe saying explicitly "you don't need to use this solution or project type to build search" would be nice, paired with how the solution makes you go faster?


## Features and tools

The {{es}} solution provides the following specialized UI tools:

### Agent Builder

[Agent Builder](/solutions/elasticsearch-solution-project/elastic-agent-builder.md) enables you to create AI agents that can interact with your {{es}} data, execute queries, and provide intelligent responses. It provides a complete framework for building conversational AI experiences on top of your search infrastructure.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

snippetable


### Playground

[Playground](/solutions/elasticsearch-solution-project/playground.md) lets you use large language models (LLMs) to understand, explore, and analyze your {{es}} data using retrieval augmented generation (RAG), via a chat interface. Playground is also useful for testing and debugging your {{es}} queries using the [retrievers](/solutions/search/retrievers-overview.md) syntax.

### Synonyms UI

The [Search with synonyms](/solutions/search/full-text/search-with-synonyms.md) interface provides a dedicated UI for managing synonym sets directly within {{kib}}, making it easier to improve search relevance without editing configuration files.

### Query Rules UI

[Query Rules UI](/solutions/elasticsearch-solution-project/query-rules-ui.md) enables you to create and manage query rules that modify search behavior based on specific conditions, helping you deliver more relevant results for common queries.

### AI Assistant

The [AI Assistant](/solutions/elasticsearch-solution-project/ai-assistant.md) provides intelligent assistance and insights across the Elastic platform, helping you understand your data and workflows more effectively.

### Model Context Protocol (MCP)

The [Model Context Protocol (MCP)](/solutions/elasticsearch-solution-project/mcp.md) lets you connect AI agents and assistants to your {{es}} data to enable natural language interactions with your indices.

## Get started

Ready to start using the {{es}} solution? Refer to [Get started](/solutions/elasticsearch-solution-project/get-started.md) for setup instructions and quickstart guides.

For a deeper understanding of search concepts and techniques, refer to the [Search use case](/solutions/search.md) documentation.

## Related reference

* [Search use case documentation](/solutions/search.md)
* [{{es}} reference documentation](elasticsearch://reference/elasticsearch/index.md)
* [{{es}} API documentation]({{es-apis}})
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ Learn how to get started by enabling the {{agent-builder}} features and begin ch
::::::{stepper}
::::{step} Set up an Elastic deployment

If you don't already have an Elastic deployment, refer to [Select your deployment type](/solutions/search/get-started.md#choose-your-deployment-type).
If you don't already have an Elastic deployment, refer to [Get started with search](/solutions/search/get-started.md).
Comment on lines 16 to +18
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this requires specifically an elasticsearch one right? can we be more particular about the requirement?


:::{note}
For {{ech}} deployments, make sure you are using the solution navigation instead of classic navigation.
Expand Down Expand Up @@ -68,7 +68,7 @@ For a broader overview of ingestion options, go to [](/manage-data/ingest.md).
:::{tip}
If you're not ready to add your own data, you can:
- Use the Elastic [sample data](/manage-data/ingest/sample-data.md).
- Generate synthetic financial data using [this Python tool](https://github.com/jeffvestal/synthetic-financial-data?tab=readme-ov-file#synthetic-financial-data-generator-). (This requires your [{{es}} URL and an API key](/solutions/search/search-connection-details.md)).
- Generate synthetic financial data using [this Python tool](https://github.com/jeffvestal/synthetic-financial-data?tab=readme-ov-file#synthetic-financial-data-generator-). (This requires your [{{es}} URL and an API key](/solutions/elasticsearch-solution-project/search-connection-details.md)).

% TODO: we can link to a an agent builder tutorial if we add one in the docs
:::
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ curl -X GET "https://${KIBANA_URL}/api/agent_builder/tools" \
```
:::{tip}
To generate API keys, search for `API keys` in the [global search bar](/explore-analyze/find-and-organize/find-apps-and-objects.md).
[Learn more](https://www.elastic.co/docs/solutions/search/search-connection-details).
[Learn more](/solutions/elasticsearch-solution-project/search-connection-details.md).
:::

### Working with Spaces
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,7 @@ export KIBANA_URL="your-kibana-url"
export API_KEY="your-api-key"
```

For information on generating API keys, refer to [API keys](https://www.elastic.co/docs/solutions/search/search-connection-details).
For information on generating API keys, refer to [API keys](/solutions/elasticsearch-solution-project/search-connection-details.md).
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this title no longer exists anywhere on the page. if you still prefer to use it, it should be updated

wonder if this page would be a better option

https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/4251/deploy-manage/api-keys/serverless-project-api-keys


Tools execute with the scope assigned to the API key. Make sure your API key has the appropriate permissions to only access the indices and data that you want to expose through the MCP server. To learn more, refer to [](#api-key-application-privileges).
:::
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@ The following models are not compatible with {{agent-builder}}:

- **OpenAI**: GPT-5-chat

Learn more about [incompatible LLMs](/solutions/search/agent-builder/limitations-known-issues.md#incompatible-llms).
Learn more about [incompatible LLMs](/solutions/elasticsearch-solution-project/agent-builder/limitations-known-issues.md#incompatible-llms).

### Why model quality matters

Expand Down
Loading
Loading