Amazon Q Business will no longer be open to new customers starting on July 31, 2026. If you would like to use the service, please sign up prior to July 30. For capabilities similar to Q Business, explore Amazon Quick. [Learn more](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/qbusiness-availability-change.html). # Configuring document attributes for boosting in Amazon Q Business **Note** Relevance tuning has replaced metadata boosting. For more information, see [Tuning the query results based on document attribute relevancy](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/relevancy-tuning.html). To boost specific documents for end user queries using document attributes, you can use the AWS Management Console or the [https://docs.aws.amazon.com/amazonq/latest/api-reference/API_DocumentAttributeBoostingConfiguration.html](https://docs.aws.amazon.com/amazonq/latest/api-reference/API_DocumentAttributeBoostingConfiguration.html) parameter of the [https://docs.aws.amazon.com/amazonq/latest/api-reference/API_UpdateRetriever.html](https://docs.aws.amazon.com/amazonq/latest/api-reference/API_UpdateRetriever.html) API operation. **Note** For `STRING` and `STRING_LIST` type document attributes to be used for boosting on the console and the API, they must be enabled for search using the [https://docs.aws.amazon.com/amazonq/latest/api-reference/API_DocumentAttributeConfiguration.html](https://docs.aws.amazon.com/amazonq/latest/api-reference/API_DocumentAttributeConfiguration.html) object of the [https://docs.aws.amazon.com/amazonq/latest/api-reference/API_UpdateIndex.html](https://docs.aws.amazon.com/amazonq/latest/api-reference/API_UpdateIndex.html) API operation. If you don't enable search on these attributes, you can't boost attributes of these data types on either the console or the API. The following tabs provide a procedure to boost document attributes using the console and code examples for the AWS CLI. ------ #### [ Console ] **To boost document attributes** 1. Sign in to the AWS Management Console and open the Amazon Q Business console. 1. In **Applications**, select the name of your application environment from the list of applications. 1. From the left navigation menu, choose **Metadata boosting**. 1. In **Metadata boosting**, choose the document attribute type that you want to boost. **Note** You can boost attributes using the following values: **None**, **Low**, **Medium**, **High**, and **Very high**. Choose from the following options: 1. **Popular** – Amazon Q displays the following popularly boosted document attributes for you to choose from: 1. **Document title** – Use to boost the title of a document. You can also use **Advanced settings** to boost specific document titles. By default, the document title attribute is enabled for search with a value of `Low`. You can change this value when you customize boosting. 1. **Last updated** – Use to boost content by its last updated date. You can also use **Advanced settings** to configure **Boosting duration**, or how long your boost should apply. 1. **File type** – Use to boost content by file type. 1. **Data sources** – Use to boost the content data source type. 1. To save your configuration, choose **Save**. 1. **Text** – Use to boost `STRING` and `STRING_LIST` type reserved or custom document attributes that you have enabled for search. Then, choose **Save**. 1. **Date** – Use to boost content using `DATE` type reserved or custom document attributes. For example, use the **Created at** document attribute to boost content based on recency. You can also use **Advanced settings** to configure **Boosting duration**, or how long your boost should apply. Then, choose **Save**. 1. **Numeric** – Use to boost content using `NUMERIC` type reserved or custom attributes. For example, use the **View count** document attribute to boost content based on view count. Based on your boosting needs, choose either **Prioritize higher values** or **Prioritize lower values**. Then, choose **Save**. 1. Once done, you can select **View web experience** to check boosting. Your configured web experience will open in a new window. ------ #### [ AWS CLI ] **Update your Amazon Q Business index to apply boosting ** This example shows how to apply `VERY_HIGH` boosting for the `STRING` type document attribute `_document_title`. ``` aws qbusiness update-retriever \ --application-id {{APPLICATION-ID}} --retriever-id {{RETRIEVER-ID}} \ --configuration '{ "nativeIndexConfiguration": { "indexId": "{{INDEX-ID}}", "boostingOverride": { "_document_title": { "stringConfiguration": { "boostingLevel": "VERY_HIGH" } } } } }' ``` This example shows how to apply boosting for the `STRING` type attribute `_category`, the `DATE` type attribute `_created_at`, the `NUMBER` type attribute `_view_count`, and the `STRING_LIST` type attribute `_authors`. ``` aws qbusiness update-retriever \ --application-id {{APPLICATION-ID}} --retriever-id {{RETRIEVER-ID}} \ --configuration '{ "nativeIndexConfiguration": { "indexId": "{{INDEX-ID}}", "boostingOverride": { "_category": { "stringConfiguration": { "boostingLevel": "LOW", "attributeValueBoosting": { "HR": "MEDIUM" } } }, "_created_at": { "dateConfiguration": { "boostingLevel": "LOW", "boostingDurationInSeconds": 2592000 } }, "_view_count": { "numberConfiguration": { "boostingLevel": "LOW", "boostingType": "PRIORITIZE_SMALLER_VALUES" } }, "_authors": { "stringListConfiguration": { "boostingLevel": "HIGH" } } } } }' ``` **Update your Amazon Q Business retriever to remove any existing boosts** This example shows how to remove any existing boosts from document attributes in your retriever. ``` aws qbusiness update-retriever \ --application-id {{APPLICATION-ID}} --retriever-id {{RETRIEVER-ID}} \ --configuration '{ "nativeIndexConfiguration": { "indexId": "{{INDEX-ID}}" } }' ``` **Get details about your Amazon Q Business retriever boosts ** This example shows how to get details for your existing boosting configuration ``` aws qbusiness get-retriever \ --application-id {{APPLICATION-ID}} --retriever-id {{RETRIEVER-ID}} ``` ------