Skip to content

Commit 5494e55

Browse files
correct content per dev feedback
1 parent 25de97a commit 5494e55

File tree

1 file changed

+9
-7
lines changed

1 file changed

+9
-7
lines changed

solutions/search/query-rules-ui.md

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -3,24 +3,26 @@ applies_to:
33
stack: ga 9.1
44
serverless: ga
55
elasticsearch:
6+
products:
7+
- id: elasticsearch
68
---
79

810
# Query rules UI
9-
Use query rules to boost, pin, or exclude specific documents when queries contain certain keywords, phrases, or match defined search patterns.
11+
Use query rules to pin or exclude specific documents when queries contain certain keywords, phrases, or match defined search patterns.
1012
The Query rules UI provides a graphical interface to manage these rules without writing API calls or JSON configuration.
1113

1214
The UI enables you to:
1315

14-
- Set keyword triggers and conditions for when rules apply
15-
- Pin, boost, or exclude specific documents in results
16+
- Set keyword or numerical conditions such as less than or greater than when rules apply
17+
- Pin or exclude specific documents in results
1618
- Organize rules into rulesets and set execution priority
1719
- Test rules against sample queries before publishing
1820

1921
## UI vs. API: What's the difference?
2022

21-
The Query Rules UI provides the same functionality as the API with one key difference in how documents are pinned:
23+
The Query Rules UI provides the same functionality as the API with one key difference:
2224

23-
* The UI defaults to `docs` for maximum flexibility, but still allows `id`-based pinning for single-index searches through a simplified form.
25+
* The UI defaults to `docs` for creating and editing rules. You cannot edit an `id` based rule that was created through the API.
2426

2527
To see examples of how to search using query rules, refer [Search using Query Rules API](https://www.elastic.co/docs/reference/elasticsearch/rest-apis/searching-with-query-rules).
2628

@@ -31,12 +33,12 @@ If you prefer to use the Query Rules API, refer to [Query Rules API]({{es-apis}}
3133
If you want to get full access to the Query Rules UI, you must have the following privileges:
3234

3335
* Appropriate roles to access Kibana. For more information, refer to [Built-in roles](https://www.elastic.co/docs/deploy-manage/users-roles/cluster-or-deployment-auth/built-in-roles) or [Kibana privileges](https://www.elastic.co/docs/deploy-manage/users-roles/cluster-or-deployment-auth/kibana-privileges)
34-
* A custom role with `manage_search_query_rules` cluster privilege
36+
* A role with `manage_search_query_rules` cluster privilege
3537
* `ALL` option for `Query Rules` role privilege in the respective Kibana space
3638

3739
## Accessing the Query Rules UI
3840

39-
Go to your deployment and select **Query Rules** from the left navigation menu under **Relevance**. If you're not able to see the option, contact the administrator to review the role assigned to you.
41+
Go to your deployment and select **Query Rules** from the left navigation menu under **Relevance**. If you're not able to see the option, contact your administrator to review the role assigned to you.
4042

4143
:::{image} /solutions/images/elasticsearch-query-rules-ui-home.png
4244
:alt: Landing page for Query Rules UI.

0 commit comments

Comments
 (0)