---
metadata:
  - name: generator
    content: Diplodoc Platform v5.70.2
alternate:
  - https://yandex.com.tr/support/direct/en/efficiency/description-queries.md
  - https://yandex.com.tr/support/direct/ru/efficiency/description-queries.md
  - href: https://yandex.com.tr/support/direct/en/efficiency/description-queries.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.com.tr/support/direct/en/llms.txt?revision=r22178319
    rel: describedby
title: Search query description
description: How the search query description feature works in search
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/support/direct/en/llms.txt?revision=r22178319


# Search query description^β^

{% note alert %}

We're rolling out search query descriptions gradually. You might not see this tool yet even if the [new targeting setup workflow](https://yandex.com.tr/support/direct/en/impression-criteria/autotargeting-upc.md#create) is already available in the interface.

{% endnote %}

To fine-tune where your ads appear, you can describe the queries you want to exclude in your own words.

You describe which search queries are relevant to your ads and which ones should be blocked. This description acts only as a filter, which means it doesn't broaden the semantic scope but narrows down the traffic pool created by autotargeting, keywords, and semantic matching. Even if you specify a suitable query, the system will filter it out if it doesn't fit your description.

This feature is only available on Yandex Search.


## Features and limitations

- **Compatibility with autotargeting categories**. Search query descriptions and autotargeting categories can't be used at the same time. The system will only apply one of these settings. If you choose a search query description and want to receive traffic from branded queries, be sure to mention your brand in the description.

- **Query matching**. The system doesn't generate new queries. Instead, it checks the ones that can trigger your ads in real time:
  - For autotargeting, queries will strictly match your description.
  - For keywords and semantic matching, the description acts as a hint. Your ads will appear more often for queries that match the meaning of your text, and less often for irrelevant ones.

- **Level of application**. This setting works at the ad group level and applies to all ads in the group. The description only defines search queries and ignores any additional context from your ad group settings (such as product feed data, display region, bid adjustments, audience segments, and other parameters). If you need to account for these parameters, split your campaign into smaller groups and create a separate description for each.

- **Length limit**. Keep your description short and concise, with no more than 500 characters.

- **Precise wording**. Write your description as a direct and clear instruction. For best results, begin your description with phrases like _“Queries must contain...”_ or _“Queries must not...”_.

  - If you want queries that mention your brand, use phrases like _“Queries must mention my brand [Brand Name]”_ or _“Queries must contain [Brand Name]”_.

  - To exclude impressions for certain brands, write: _“Queries must not contain brand names [Brand Names]”_.

- **Evaluating results**. After adding your text, check the forecast and sample queries under the **Selected** and **Excluded** tabs. You'll see real-world queries that can trigger your ads. If these queries don't match your goal, adjust your description.


## How to write a search query description

To help our algorithms target the right audience, describe in detail what users should be searching for and which queries to exclude. Please include the brand, model, or product features if they matter for your sales, and make sure there are no conflicting conditions.

### Examples of good and bad descriptions

#|
||
**Good description**
|
**Bad description**
||
||
1. Be clear about what the user is looking for.

   ![button-ok](../_assets/button-ok.png) _“Queries must focus on buying an apartment in a new building, including mortgages. Rentals and resale properties aren't relevant.”_

|
1. Don't use descriptions with vague wording. Vague descriptions make it hard to determine which queries match your goals.

   ![button-cancel](../_assets/button-cancel.png) _“Target only interested customers”_
||
||
2. Make it clear which product contexts are relevant and which ones are not.

   ![button-ok](../_assets/button-ok.png) _“Queries must focus on smart speakers with Alice: how to choose one, pricing, and where to buy. Exclude queries about Alice on mobile phones.”_
|
2. To avoid accidentally filtering out target traffic, don't exclude words that might appear in relevant queries.

   ![button-cancel](../_assets/button-cancel.png) _“Queries should be about ophthalmologists, but they should not include the word 'doctor'”_ (this description may filter out target queries like _“book a doctor appointment with an ophthalmologist”_)
||
||
3. Specify the product line or model within the brand.

   ![button-ok](../_assets/button-ok.png) _“Queries must be specifically about Yandex Station Mini. Generic queries about smart speakers with Alice or other models aren't relevant.”_
|
3. Don't list too many words at once.

   ![button-cancel](../_assets/button-cancel.png) _“Queries must include the words 'buy', 'speaker', 'Alice', and 'cheap'”_ (this description may filter out relevant queries like _“pricing of smart speakers with Alice”_)
||
||
4. If the region matters, mention it in the description.

   ![button-ok](../_assets/button-ok.png) _“Queries must mention Moscow”_
|
4. Don't reference autotargeting categories, ad group settings, or ad content.

   ![button-cancel](../_assets/button-cancel.png) _“Show ads for queries that mention the region from the ad group”_

   ![button-cancel](../_assets/button-cancel.png) _“Don't select queries from the applicable autotargeting category”_
||
|#


Whenever you change your description, check the forecast and sample queries under the **Selected** and **Excluded** tabs. This way, you can verify that your description is clear and matches queries correctly.


## How to configure

1. On the ad group settings page, under the **Exclude queries and audiences** section, click **Add** → **Search query description**.
2. Enter your description and click **Apply**.
3. Check the results in the impressions forecast section under the **Selected** and **Excluded** tabs.

{% note info %}

Search query descriptions aren't supported in the [Direct Commander](https://yandex.ru/support/direct-commander-new/ru/) interface. Managing this setting via [XLS/XLSX files](https://yandex.com.tr/support/direct/en/alternative-interfaces/xls-interface.md) and the [Yandex Direct API](https://yandex.com.tr/support/direct/en/alternative-interfaces/api.md) isn't available either.

You can manage or disable this feature in the web interface or the mobile app.

{% endnote %}



<!-- source: en/_includes/footer.md -->
#### Have questions? {#questions}

<!-- как увидеть логин -->

<!-- source: en/_includes/res/id-res/only-login.md -->
{% note alert %}

Our customer service department can only help you with the campaigns created under the same username you use to contact us. You can check your username by opening [ya.ru](http://ya.ru/) in another browser tab. Our team can access your data only when processing your request.

{% endnote %}
<!-- endsource: en/_includes/res/id-res/only-login.md -->

<!--Qr мессенджеры -->


<!-- source: en/_includes/contacts-footer/messengers-qr.md -->
Scan the QR code or tap it to follow the link.





<div class="footer-col-social">

<div class="social-card"> <!-- telegram ссылка как в ru-->

<a href="https://t.me/YandexDirectSupportBot?utm_source=direct&utm_medium=help&utm_campaign=ru" target="_blank">
    <img src="https://yastatic.net/s3/doc-binary/src/support/direct/ru/files/telegram-qr.png" style="width: 96px;">
</a>

</div>


<div class="social-card"> <!-- watsapp -->

<a href="https://wa.me/74951399193?utm_source=direct&utm_medium=help&utm_campaign=en" target="_blank">
    <img src="https://yastatic.net/s3/doc-binary/src/support/direct/ru/files/watsapp-qr-en.png" style="width: 96px;">
</a>

</div> 

</div>

If you choose Telegram or WhatsApp, keep in mind that Yandex doesn't control and takes no responsibility for how third-party messaging apps store your chats and data.


<!-- source: en/_includes/contacts-footer/contacts-style.md -->
<!-- стили желтых кнопок-катов: -->



<!-- стили желтой кнопки-ссылки: -->



<!-- стили куар-кодов: -->


<!-- стили полезных ссылок: -->


<!-- endsource: en/_includes/contacts-footer/contacts-style.md -->
<!-- endsource: en/_includes/contacts-footer/messengers-qr.md -->


<!--Написать в чат желтая кнопка-ссылка -->


<!--Позвонить желтая кнопка-кат -->


<!-- source: en/_includes/contacts-footer/call.md -->
<div class="cut-button">

{% cut "Call" %}

You can contact us from 10:00 to 19:00 (UTC+3) by phone:

**Moscow**: [+7 495 139-91-93](tel:+74951399193)

**Russian regions**: [8 (800) 700-47-45](tel:88007004745) (toll-free within Russia)

To access campaigns, the customer service specialist will need your [PIN](https://yandex.com.tr/support/direct/en/troubleshooting/pin-code.md).

{% endcut %}

</div>


<!-- source: en/_includes/contacts-footer/contacts-style.md -->
<!-- стили желтых кнопок-катов: -->



<!-- стили желтой кнопки-ссылки: -->



<!-- стили куар-кодов: -->


<!-- стили полезных ссылок: -->


<!-- endsource: en/_includes/contacts-footer/contacts-style.md -->
<!-- endsource: en/_includes/contacts-footer/call.md -->


<!--Написать письмо желтая кнопка-кат -->


<!-- source: en/_includes/contacts-footer/mail-forms-footer.md -->
<!-- желтая кнопка-кат: -->
<div class="cut-button">

{% cut "Leave a message" %}

<iframe form-id="1435" collapsed="no" collapsible="no" form-title="Contact customer service" id="all-p" width="100%" src="https://forms.yandex.ru/surveys/1435/?lang=en&title=%D0%9E%20%D1%87%D0%B5%D0%BC%20%D0%B2%D1%8B%20%D1%85%D0%BE%D1%82%D0%B8%D1%82%D0%B5%20%D1%81%D0%BF%D1%80%D0%BE%D1%81%D0%B8%D1%82%D1%8C%3F&requestid=1678345963548777-1444993988871094178-vla1-3501-vla-l7-balancer-8080-BAL-7399&iframe=1&path=%2Fsupport%2Faudience%2Ftroubleshooting%2Fstart.html&feedback_sid=8935512981673750718&mobile=false&service=audience&referer=https%3A%2F%2Fyandex.ru%2Fsupport%2Faudience%2Fdelete-data.html&url=https%3A%2F%2Fyandex.ru%2Fsupport%2Faudience%2Ftroubleshooting%2Fstart.html" frameborder="0" style="background: #FFFFFF; border-radius: 10px; padding: 18px"></iframe>

{% endcut %}

</div>




<!-- source: en/_includes/contacts-footer/contacts-style.md -->
<!-- стили желтых кнопок-катов: -->



<!-- стили желтой кнопки-ссылки: -->



<!-- стили куар-кодов: -->


<!-- стили полезных ссылок: -->


<!-- endsource: en/_includes/contacts-footer/contacts-style.md -->
<!-- endsource: en/_includes/contacts-footer/mail-forms-footer.md -->


<!-- Свяжитесь с нами желтая кнопка-ссылка: -->


<!-- полезные ссылки: -->

<!-- source: en/_includes/contacts-footer/useful-links.md -->
<br>
<br>


<div class="grid-container">
    <div class="grid-item">
        <div><p><h3><span style="font-weight:normal">Useful links</span></h3></p>
        <ul>
            <li><a href="https://direct.yandex.com/dna/grid/campaigns">My campaigns</a></li>
            <p></p>
            <li><a href="https://wordstat.yandex.ru/">Wordstat</a></li>
            <p></p>
            <li><a href="https://yandex.com/support/direct/en/payments/payment-methods">Payment methods</a></li>
            <p></p>
            <li><a href="https://yandex.com/support/direct/en/troubleshooting/other">Contacts</a></li>
        </ul>
        </div>
    </div>
    <div class="grid-item">
        <div><p><h3><span style="font-weight:normal">Legal documents</span></h3></p>
        <ul>
            <li><a href="https://yandex.com/legal/direct_adv_rules_ch/en/">Advertising requirements</a></li>
            <p></p>
            <li><a href="https://yandex.com/legal/direct_display_rules_ch/en/">Display rules</a></li>
            <p></p>
            <li><a href="https://yandex.com/legal/offer_direct_ae/en/">Terms of service</a></li>
        </ul>
        </div>
    </div>
    <div class="grid-item">
        <div><p><h3><span style="font-weight:normal">Training</span></h3></p>
        <ul>
           <li><a href="https://yandex.com/adv/edu?menu=open">Online courses</a></li>
        </ul>
        </div>
    </div>
    <div class="grid-item">
        <div><p><h3><span style="font-weight:normal">Learn more</span></h3></p>
        <ul>
           <li><a href="https://yandex.com/adv/news">New in Yandex Direct</a></li>
           <p></p>
           <li><a href="https://yandex.com/adv/solutions?menu=open">Yandex customer cases</a></li>
        </ul>
        </div>
    </div>
</div> 






<!-- source: en/_includes/contacts-footer/contacts-style.md -->
<!-- стили желтых кнопок-катов: -->



<!-- стили желтой кнопки-ссылки: -->



<!-- стили куар-кодов: -->


<!-- стили полезных ссылок: -->


<!-- endsource: en/_includes/contacts-footer/contacts-style.md -->
<!-- endsource: en/_includes/contacts-footer/useful-links.md -->
<!-- endsource: en/_includes/footer.md -->

