From a6011c0d8029052f5f9cb749e32dad2141732795 Mon Sep 17 00:00:00 2001 From: Michail Romaios Date: Tue, 15 Jul 2025 17:17:53 +0200 Subject: [PATCH] docs: add sort note in pinned_query --- .../query-languages/query-dsl/query-dsl-pinned-query.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/reference/query-languages/query-dsl/query-dsl-pinned-query.md b/docs/reference/query-languages/query-dsl/query-dsl-pinned-query.md index 018cb3d5fd2dd..d223d971b4249 100644 --- a/docs/reference/query-languages/query-dsl/query-dsl-pinned-query.md +++ b/docs/reference/query-languages/query-dsl/query-dsl-pinned-query.md @@ -7,6 +7,10 @@ mapped_pages: Promotes selected documents to rank higher than those matching a given query. This feature is typically used to guide searchers to curated documents that are promoted over and above any "organic" matches for a search. The promoted or "pinned" documents are identified using the document IDs stored in the [`_id`](/reference/elasticsearch/mapping-reference/mapping-id-field.md) field. +::::{note} +Pinned queries are designed to work only with relevance-based sorting. Using explicit `sort` criteria overrides the pinned document promotion. +:::: + ## Example request [_example_request] ```console