---
title: Elasticsearch
description: 
url: https://www.elastic.co/elastic/docs-builder/docs/3557/products/elasticsearch/v9
---

# Elasticsearch
<hero>
</hero>

<on-this-page>
</on-this-page>

<intro>
  **New to Elasticsearch?** [Follow the quick start](https://docs-v3-preview.elastic.dev/elastic/docs-builder/docs/3557/reference/elasticsearch/rest-apis/api-examples) to run your first queries, or explore [how to bring your data in](https://www.elastic.co/elastic/docs-builder/docs/3557/manage-data/ingest) and start searching in minutes.
</intro>

<whats-new>
</whats-new>

<card-group>
  <link-card title="Self-managed">
    title: Self-managed
    link: /deploy-manage/deploy/self-managed/installing-elasticsearch.md
    description: Install and run Elasticsearch on your own infrastructure.
    links:
    - label: Docker
      url: /deploy-manage/deploy/self-managed/install-elasticsearch-with-docker.md
    - label: Debian / Ubuntu
      url: /deploy-manage/deploy/self-managed/install-elasticsearch-with-debian-package.md
    - label: RPM
      url: /deploy-manage/deploy/self-managed/install-elasticsearch-with-rpm.md
    - label: Windows
      url: /deploy-manage/deploy/self-managed/install-elasticsearch-with-zip-on-windows.md
    - label: Linux / macOS archive
      url: /deploy-manage/deploy/self-managed/install-elasticsearch-from-archive-on-linux-macos.md
    - label: Configure Elasticsearch
      url: /deploy-manage/deploy/self-managed/configure-elasticsearch.md
    - label: Secure a self-managed cluster
      url: /deploy-manage/deploy/self-managed/tutorial-self-managed-secure.md
  </link-card>

  <link-card title="Managed deployments">
    title: Managed deployments
    link: /deploy-manage/deploy/elastic-cloud.md
    description: Run Elasticsearch on Elastic Cloud, Kubernetes, or ECE.
    links:
    - label: Elastic Cloud Hosted
      url: /deploy-manage/deploy/elastic-cloud.md
    - label: Elastic Cloud on Kubernetes (ECK)
      url: /deploy-manage/deploy/cloud-on-k8s.md
    - label: Elastic Cloud Enterprise (ECE)
      url: /deploy-manage/deploy/cloud-enterprise.md
  </link-card>

  <link-card title="Maintain and monitor">
    title: Maintain and monitor
    link: /deploy-manage/maintenance/start-stop-services/start-stop-elasticsearch.md
    description: Production guidance, upgrades, cluster health, and diagnostics.
    links:
    - label: Start and stop Elasticsearch
      url: /deploy-manage/maintenance/start-stop-services/start-stop-elasticsearch.md
    - label: Stack monitoring
      url: /deploy-manage/monitor/stack-monitoring/elasticsearch-monitoring-self-managed.md
    - label: Capture diagnostics
      url: /troubleshoot/elasticsearch/diagnostic.md
    - label: Troubleshoot
      url: /troubleshoot/elasticsearch.md
    - label: Snapshot and restore
      url: /deploy-manage/tools/snapshot-and-restore.md
  </link-card>
</card-group>

<card-group>
  <link-card title="Ingest pipelines">
    title: Ingest pipelines
    link: /manage-data/ingest/transform-enrich/ingest-pipelines.md
    description: Pre-process documents before indexing with processors that parse, transform, and enrich your data.
    links:
    - label: Overview and setup
      url: /manage-data/ingest/transform-enrich/ingest-pipelines.md
    - label: Simulate ingestion (API)
      url: [https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-simulate-ingest](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-simulate-ingest)
    - label: All ingest methods
      url: /manage-data/ingest.md
  </link-card>

  <link-card title="Data streams">
    title: Data streams
    link: /manage-data/data-store/data-streams.md
    description: Manage time-series data with a single resource that spans multiple backing indices.
    links:
    - label: Data streams overview
      url: /manage-data/data-store/data-streams.md
    - label: Manage data streams
      url: /manage-data/data-store/data-streams/manage-data-stream.md
    - label: Logs data stream (logsdb)
      url: /manage-data/data-store/data-streams/logs-data-stream.md
  </link-card>

  <link-card title="Document APIs">
    title: Document APIs
    link: [https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-index](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-index)
    description: Index, update, delete, and retrieve documents with the core document APIs.
    links:
    - label: Index a document
      url: [https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-index](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-index)
    - label: Bulk API
      url: [https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-bulk](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-bulk)
    - label: Reindex API
      url: [https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-reindex](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-reindex)
    - label: Reindex examples
      url: elasticsearch://reference/elasticsearch/rest-apis/reindex-indices.md
    - label: Migrate data between clusters
      url: /manage-data/migrate/migrate-data-between-elasticsearch-clusters-with-minimal-downtime.md
  </link-card>
</card-group>

<card-group>
  <link-card title="Query DSL">
    title: Query DSL
    link: elasticsearch://reference/query-languages/query-dsl/full-text-queries.md
    description: Write expressive queries using the JSON-based Domain Specific Language — from simple term filters to compound boolean queries.
    links:
    - label: Full-text search
      url: /solutions/search/full-text.md
    - label: Full-text queries
      url: elasticsearch://reference/query-languages/query-dsl/full-text-queries.md
    - label: Search API
      url: [https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-search](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-search)
    - label: Cross-cluster search
      url: /explore-analyze/cross-cluster-search.md
      aside:
      label: Query types
      links:
      - label: Full-text
      url: elasticsearch://reference/query-languages/query-dsl/full-text-queries.md
    - label: Term-level
      url: elasticsearch://reference/query-languages/querydsl.md
    - label: Geo
      url: elasticsearch://reference/query-languages/querydsl.md
    - label: Shape
      url: elasticsearch://reference/query-languages/querydsl.md
    - label: Joining
      url: elasticsearch://reference/query-languages/querydsl.md
    - label: Span
      url: elasticsearch://reference/query-languages/querydsl.md
  </link-card>

  <link-card title="ES|QL">
    title: ES|QL
    link: elasticsearch://reference/query-languages/esql/esql-getting-started.md
    description: A pipe-based query language purpose-built for filtering, transforming, and analyzing data — usable from the API, Kibana Discover, or directly in search.
    links:
    - label: Get started with ES|QL
      url: elasticsearch://reference/query-languages/esql/esql-getting-started.md
    - label: Syntax reference
      url: elasticsearch://reference/query-languages/esql/esql-syntax-reference.md
    - label: Commands
      url: elasticsearch://reference/query-languages/esql/esql-commands.md
    - label: ES|QL for search
      url: /solutions/search/esql-for-search.md
    - label: Cross-cluster ES|QL
      url: elasticsearch://reference/query-languages/esql/esql-cross-clusters.md
  </link-card>

  <link-card title="Other query languages">
    title: Other query languages
    link: elasticsearch://reference/query-languages/index.md
    description: Use EQL for event sequences, SQL for familiar syntax, or Painless for custom scoring and scripted queries.
    links:
    - label: EQL (Event Query Language)
      url: [https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-eql-search](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-eql-search)
    - label: SQL
      url: [https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-sql-query](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-sql-query)
    - label: Translate SQL to Query DSL
      url: [https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-sql-translate](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-sql-translate)
    - label: Painless scripting
      url: /explore-analyze/scripting/modules-scripting-painless.md
  </link-card>
</card-group>

<card-group>
  <link-card title="Aggregations overview">
    title: Aggregations overview
    link: /explore-analyze/query-filter/aggregations.md
    description: Summarize and compute statistics over your data — counts, averages, histograms, date ranges, and more.
    links:
    - label: Introduction
      url: /explore-analyze/query-filter/aggregations.md
    - label: 'Tutorial: eCommerce data analysis'
      url: /explore-analyze/query-filter/aggregations/tutorial-analyze-ecommerce-data-with-aggregations-using-query-dsl.md
      aside:
      label: Aggregation families
      links:
      - label: Metric
      url: elasticsearch://reference/aggregations/index.md
    - label: Bucket
      url: elasticsearch://reference/aggregations/index.md
    - label: Pipeline
      url: elasticsearch://reference/aggregations/index.md
    - label: Matrix
      url: elasticsearch://reference/aggregations/index.md
  </link-card>

  <link-card title="Metric aggregations">
    title: Metric aggregations
    link: elasticsearch://reference/aggregations/index.md
    description: Compute single numeric values from field data — min, max, avg, sum, percentiles, stats, and more.
    links:
    - label: Top hits
      url: elasticsearch://reference/aggregations/search-aggregations-metrics-top-hits-aggregation.md
    - label: Top metrics
      url: elasticsearch://reference/aggregations/search-aggregations-metrics-top-metrics.md
    - label: Cardinality, percentiles, stats
      url: elasticsearch://reference/aggregations/index.md
  </link-card>

  <link-card title="Bucket and pipeline aggregations">
    title: Bucket and pipeline aggregations
    link: elasticsearch://reference/aggregations/index.md
    description: Group documents into buckets, then chain pipeline aggregations to compute on those buckets.
    links:
    - label: Filters aggregation
      url: elasticsearch://reference/aggregations/search-aggregations-bucket-filters-aggregation.md
    - label: Multi-terms aggregation
      url: elasticsearch://reference/aggregations/search-aggregations-bucket-multi-terms-aggregation.md
    - label: Avg bucket (pipeline)
      url: elasticsearch://reference/aggregations/search-aggregations-pipeline-avg-bucket-aggregation.md
    - label: Bucket script (pipeline)
      url: elasticsearch://reference/aggregations/search-aggregations-pipeline-bucket-script-aggregation.md
  </link-card>
</card-group>

<card-group>
  <link-card title="Mapping">
    title: Mapping
    link: elasticsearch://reference/elasticsearch/mapping-reference/index.md
    description: Define how documents and their fields are stored, indexed, and analyzed.
    links:
    - label: Field data types
      url: elasticsearch://reference/elasticsearch/mapping-reference/field-data-types.md
    - label: Dynamic field mapping
      url: /manage-data/data-store/mapping/dynamic-field-mapping.md
    - label: Runtime fields
      url: /manage-data/data-store/mapping/define-runtime-fields-in-search-request.md
    - label: Update mappings (examples)
      url: /manage-data/data-store/mapping/update-mappings-examples.md
    - label: Put mapping API
      url: [https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-put-mapping](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-put-mapping)
      aside:
      label: Common field types
      links:
      - label: keyword
      url: elasticsearch://reference/elasticsearch/mapping-reference/field-data-types.md
    - label: text
      url: elasticsearch://reference/elasticsearch/mapping-reference/field-data-types.md
    - label: date
      url: elasticsearch://reference/elasticsearch/mapping-reference/field-data-types.md
    - label: dense_vector
      url: elasticsearch://reference/elasticsearch/mapping-reference/field-data-types.md
    - label: semantic_text
      url: elasticsearch://reference/elasticsearch/mapping-reference/field-data-types.md
    - label: geo_point
      url: elasticsearch://reference/elasticsearch/mapping-reference/field-data-types.md
  </link-card>

  <link-card title="Text analysis">
    title: Text analysis
    link: /manage-data/data-store/text-analysis/configure-text-analysis.md
    description: Control how text is tokenized and indexed to optimize relevance and search recall.
    links:
    - label: Configure text analysis
      url: /manage-data/data-store/text-analysis/configure-text-analysis.md
    - label: Create a custom analyzer
      url: /manage-data/data-store/text-analysis/create-custom-analyzer.md
    - label: Specify an analyzer
      url: /manage-data/data-store/text-analysis/specify-an-analyzer.md
    - label: Analyze API
      url: [https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-analyze](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-analyze)
    - label: Analyzers, tokenizers, and filters reference
      url: /reference/text-analysis.md
  </link-card>

  <link-card title="Configuration reference">
    title: Configuration reference
    link: elasticsearch://reference/elasticsearch/configuration-reference/index.md
    description: All Elasticsearch node settings — network, thread pools, index defaults, security, and more.
    links:
    - label: Node settings
      url: elasticsearch://reference/elasticsearch/configuration-reference/node-settings.md
    - label: Security settings
      url: elasticsearch://reference/elasticsearch/configuration-reference/security-settings.md
    - label: All settings reference
      url: elasticsearch://reference/elasticsearch/configuration-reference/index.md
  </link-card>
</card-group>

<card-group>
  <link-card title="Index lifecycle management (ILM)">
    title: Index lifecycle management (ILM)
    link: /manage-data/lifecycle/index-lifecycle-management.md
    description: Automate index policies to move data through hot, warm, cold, and frozen tiers — and eventually delete it.
    links:
    - label: Create an ILM policy
      url: /manage-data/lifecycle/index-lifecycle-management/configure-lifecycle-policy.md
    - label: Tutorials
      url: /manage-data/lifecycle/index-lifecycle-management/ilm-tutorials.md
    - label: Check ILM status
      url: /manage-data/lifecycle/index-lifecycle-management/policy-view-status.md
    - label: Start and stop ILM
      url: /manage-data/lifecycle/index-lifecycle-management/start-stop-index-lifecycle-management.md
    - label: Explain lifecycle (API)
      url: [https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-ilm-explain-lifecycle](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-ilm-explain-lifecycle)
  </link-card>

  <link-card title="Data stream lifecycle">
    title: Data stream lifecycle
    link: /manage-data/lifecycle/data-stream.md
    description: Set built-in retention and rollover directly on data streams, without a separate ILM policy.
    links:
    - label: Data stream lifecycle overview
      url: /manage-data/lifecycle/data-stream.md
    - label: Update an existing data stream
      url: /manage-data/lifecycle/data-stream/tutorial-update-existing-data-stream.md
    - label: Manage data tiers
      url: /manage-data/lifecycle/data-tiers/manage-data-tiers-self-managed-eck.md
  </link-card>

  <link-card title="Snapshot and restore">
    title: Snapshot and restore
    link: /deploy-manage/tools/snapshot-and-restore.md
    description: Back up indices and data streams to a remote repository and restore them when needed.
    links:
    - label: Overview
      url: /deploy-manage/tools/snapshot-and-restore.md
    - label: Restore a snapshot
      url: /deploy-manage/tools/snapshot-and-restore/restore-snapshot.md
    - label: Create a snapshot repository (API)
      url: [https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-snapshot-create-repository](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-snapshot-create-repository)
    - label: Create a snapshot (API)
      url: [https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-snapshot-create](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-snapshot-create)
    - label: Troubleshoot snapshots
      url: /troubleshoot/elasticsearch/snapshot-and-restore.md
  </link-card>
</card-group>

<card-group>
  <link-card title="Semantic search">
    title: Semantic search
    link: /solutions/search/semantic-search/semantic-search-semantic-text.md
    description: Search by meaning rather than exact keywords using dense or sparse vector embeddings.
    links:
    - label: Semantic search with semantic_text
      url: /solutions/search/semantic-search/semantic-search-semantic-text.md
    - label: Semantic search with ELSER
      url: /solutions/search/semantic-search/semantic-search-elser-ingest-pipelines.md
    - label: Get started with semantic search
      url: /solutions/search/get-started/semantic-search.md
    - label: Dense vs. sparse ingest pipelines
      url: /solutions/search/vector/dense-versus-sparse-ingest-pipelines.md
  </link-card>

  <link-card title="Vector search (kNN)">
    title: Vector search (kNN)
    link: /solutions/search/vector/knn.md
    description: Find the nearest neighbors to a query vector for similarity-based retrieval and hybrid search.
    links:
    - label: kNN search
      url: /solutions/search/vector/knn.md
    - label: Sparse vector search
      url: /solutions/search/vector/sparse-vector.md
    - label: Bring your own vectors
      url: /solutions/search/vector/bring-own-vectors.md
    - label: kNN retriever
      url: elasticsearch://reference/elasticsearch/rest-apis/retrievers/knn-retriever.md
    - label: kNN in ES|QL
      url: elasticsearch://reference/query-languages/esql/functions-operators/dense-vector-functions/knn.md
  </link-card>

  <link-card title="Inference API">
    title: Inference API
    link: [https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-inference-put](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-inference-put)
    description: Connect Elasticsearch to external AI model providers for embeddings, reranking, and completions.
    links:
    - label: Create an inference endpoint
      url: [https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-inference-put](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-inference-put)
    - label: ELSER inference endpoint
      url: [https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-inference-put-elser](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-inference-put-elser)
      aside:
      label: Supported providers
      links:
      - label: OpenAI
      url: [https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-inference-put](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-inference-put)
    - label: Cohere
      url: [https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-inference-put](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-inference-put)
    - label: Anthropic
      url: [https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-inference-put](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-inference-put)
    - label: Azure
      url: [https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-inference-put](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-inference-put)
    - label: Google
      url: [https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-inference-put](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-inference-put)
    - label: Hugging Face
      url: [https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-inference-put](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-inference-put)
    - label: Mistral
      url: [https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-inference-put](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-inference-put)
  </link-card>
</card-group>

<card-group>
  <link-card title="Encryption and TLS">
    title: Encryption and TLS
    link: /deploy-manage/security/secure-cluster-communications.md
    description: Encrypt communications between nodes and between clients and the cluster.
    links:
    - label: Set up basic security (TLS)
      url: /deploy-manage/security/set-up-basic-security.md
    - label: Secure cluster communications
      url: /deploy-manage/security/secure-cluster-communications.md
    - label: Secure HTTP clients
      url: /deploy-manage/security/httprest-clients-security.md
    - label: Security settings reference
      url: elasticsearch://reference/elasticsearch/configuration-reference/security-settings.md
  </link-card>

  <link-card title="Authentication">
    title: Authentication
    link: /deploy-manage/users-roles/cluster-or-deployment-auth/ldap.md
    description: Verify user identity with native realms, LDAP, Active Directory, SAML, OIDC, PKI, and more.
    links:
    - label: LDAP authentication
      url: /deploy-manage/users-roles/cluster-or-deployment-auth/ldap.md
    - label: SAML authentication (API)
      url: [https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-security-saml-authenticate](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-security-saml-authenticate)
    - label: All authentication methods
      url: /deploy-manage/users-roles/cluster-or-deployment-auth.md
  </link-card>

  <link-card title="Authorization and RBAC">
    title: Authorization and RBAC
    link: /deploy-manage/users-roles.md
    description: Control what users and applications can access using roles, privileges, and field- and document-level security.
    links:
    - label: Users and roles overview
      url: /deploy-manage/users-roles.md
    - label: Create or update a role (API)
      url: [https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-security-put-role](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-security-put-role)
    - label: Create or update a user (API)
      url: [https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-security-put-user](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-security-put-user)
  </link-card>
</card-group>

<card-group>
  <link-card title="Language clients">
    title: Language clients
    link: /reference/elasticsearch-clients.md
    description: Official Elasticsearch clients for your preferred programming language.
    links:
    - label: Python
      url: elasticsearch-py://reference/index.md
    - label: Java
      url: elasticsearch-java://reference/getting-started.md
    - label: Go
      url: go-elasticsearch://reference/using-the-api/dense-vectors.md
    - label: Rust
      url: elasticsearch-rs://reference/index.md
    - label: PHP
      url: elasticsearch-php://reference/index.md
    - label: Ruby
      url: elasticsearch-ruby://reference/api.md
    - label: Community clients
      url: elasticsearch://reference/community-contributed/index.md
  </link-card>

  <link-card title="Python DSL and helpers">
    title: Python DSL and helpers
    link: elasticsearch-py://reference/elasticsearch-dsl.md
    description: High-level Python libraries that simplify building queries, mappings, and bulk operations.
    links:
    - label: Elasticsearch DSL (Python)
      url: elasticsearch-py://reference/elasticsearch-dsl.md
    - label: Java bulk indexing
      url: elasticsearch-java://reference/usage/indexing-bulk.md
    - label: Troubleshoot clients
      url: /troubleshoot/elasticsearch/clients.md
  </link-card>

  <link-card title="Ingest tools">
    title: Ingest tools
    link: /manage-data/ingest.md
    description: Get data into Elasticsearch using Fleet, Logstash, Beats, or search connectors.
    links:
    - label: Fleet and Elastic Agent
      url: /reference/fleet.md
    - label: Content connectors
      url: elasticsearch://reference/search-connectors/index.md
    - label: All ingest options
      url: /manage-data/ingest.md
  </link-card>
</card-group>

<card-group>
  <link-card title="REST APIs">
    title: REST APIs
    link: elasticsearch://reference/elasticsearch/rest-apis/index.md
    description: Conventions, common options, compatibility guarantees, and the full interactive API specification.
    links:
    - label: API conventions
      url: elasticsearch://reference/elasticsearch/rest-apis/api-conventions.md
    - label: Common options
      url: elasticsearch://reference/elasticsearch/rest-apis/common-options.md
    - label: API compatibility
      url: elasticsearch://reference/elasticsearch/rest-apis/compatibility.md
    - label: Examples and quick start
      url: elasticsearch://reference/elasticsearch/rest-apis/api-examples.md
    - label: Full API reference
      url: [https://www.elastic.co/docs/api/doc/elasticsearch](https://www.elastic.co/docs/api/doc/elasticsearch)
  </link-card>

  <link-card title="Painless scripting">
    title: Painless scripting
    link: /explore-analyze/scripting/modules-scripting-painless.md
    description: Write custom scripts in Painless for queries, aggregations, ingest processors, and runtime fields.
    links:
    - label: Introduction to Painless
      url: /explore-analyze/scripting/modules-scripting-painless.md
    - label: Language specification
      url: elasticsearch://reference/scripting-languages/painless/painless-language-specification.md
    - label: Use Painless in runtime fields
      url: elasticsearch://reference/scripting-languages/painless/use-painless-scripts-in-runtime-fields.md
    - label: Scripts reference
      url: elasticsearch://reference/scripting-languages/painless/painless-scripts.md
  </link-card>

  <link-card title="Release notes">
    title: Release notes
    link: elasticsearch://release-notes/index.md
    description: What's new, deprecated, and fixed in each Elasticsearch release.
    links:
    - label: Elasticsearch
      url: elasticsearch://release-notes/index.md
    - label: Breaking changes
      url: /release-notes/elasticsearch/breaking-changes.md
    - label: Deprecations
      url: /release-notes/elasticsearch/deprecations.md
      aside:
      label: Client release notes
      links:
      - label: Python
      url: /release-notes/elasticsearch/clients/python.md
    - label: Java
      url: /release-notes/elasticsearch/clients/java.md
    - label: .NET
      url: /release-notes/elasticsearch/clients/dotnet.md
    - label: PHP
      url: /release-notes/elasticsearch/clients/php.md
    - label: Ruby
      url: /release-notes/elasticsearch/clients/ruby.md
  </link-card>

  <link-card title="Troubleshooting">
    title: Troubleshooting
    link: /troubleshoot/elasticsearch.md
    description: Diagnose and fix common Elasticsearch cluster, performance, and operational issues.
    links:
    - label: Cluster issues
      url: /troubleshoot/elasticsearch/clusters.md
    - label: Snapshot and restore
      url: /troubleshoot/elasticsearch/snapshot-and-restore.md
    - label: Clients
      url: /troubleshoot/elasticsearch/clients.md
    - label: Capture diagnostics
      url: /troubleshoot/elasticsearch/diagnostic.md
  </link-card>
</card-group>