JetBrains · eldar-jetbrains · Jun 18, 2025 · Jul 28, 2025 · Aug 15, 2025 · Aug 29, 2025
diff --git a/images/ui/search_field/clear-search-correct.png b/images/ui/search_field/clear-search-correct.png
diff --git a/images/ui/search_field/clear-search-incorrect.png b/images/ui/search_field/clear-search-incorrect.png
diff --git a/images/ui/search_field/completion-filtered.png b/images/ui/search_field/completion-filtered.png
diff --git a/images/ui/search_field/completion-mes-2.png b/images/ui/search_field/completion-mes-2.png
diff --git a/images/ui/search_field/completion-mes.png b/images/ui/search_field/completion-mes.png
diff --git a/images/ui/search_field/completion-variants.png b/images/ui/search_field/completion-variants.png
diff --git a/images/ui/search_field/filters-correct.png b/images/ui/search_field/filters-correct.png
diff --git a/images/ui/search_field/filters-incorrect.png b/images/ui/search_field/filters-incorrect.png
diff --git a/images/ui/search_field/keymap-search-correct.png b/images/ui/search_field/keymap-search-correct.png
diff --git a/images/ui/search_field/keymap-search-incorrect.png b/images/ui/search_field/keymap-search-incorrect.png
diff --git a/images/ui/search_field/log-correct.png b/images/ui/search_field/log-correct.png
diff --git a/images/ui/search_field/log-focused.png b/images/ui/search_field/log-focused.png
diff --git a/images/ui/search_field/log-incorrect.png b/images/ui/search_field/log-incorrect.png
diff --git a/images/ui/search_field/multiline-mes.png b/images/ui/search_field/multiline-mes.png
diff --git a/images/ui/search_field/multiline-scrollbar.png b/images/ui/search_field/multiline-scrollbar.png
diff --git a/images/ui/search_field/multiline.png b/images/ui/search_field/multiline.png
diff --git a/images/ui/search_field/new-line.png b/images/ui/search_field/new-line.png
diff --git a/images/ui/search_field/newline-options.png b/images/ui/search_field/newline-options.png
diff --git a/images/ui/search_field/options-focused.png b/images/ui/search_field/options-focused.png
diff --git a/images/ui/search_field/options-hovered.png b/images/ui/search_field/options-hovered.png
diff --git a/images/ui/search_field/options-on.png b/images/ui/search_field/options-on.png
diff --git a/images/ui/search_field/options.png b/images/ui/search_field/options.png
diff --git a/images/ui/search_field/placeholder.png b/images/ui/search_field/placeholder.png
diff --git a/images/ui/search_field/popup-correct.png b/images/ui/search_field/popup-correct.png
diff --git a/images/ui/search_field/popup-incorrect.png b/images/ui/search_field/popup-incorrect.png
diff --git a/images/ui/search_field/ptree-correct.png b/images/ui/search_field/ptree-correct.png
diff --git a/images/ui/search_field/ptree-incorrect.png b/images/ui/search_field/ptree-incorrect.png
diff --git a/images/ui/search_field/ptree-sizes.png b/images/ui/search_field/ptree-sizes.png
diff --git a/images/ui/search_field/search-everywhere.png b/images/ui/search_field/search-everywhere.png
diff --git a/images/ui/search_field/search-history-empty.png b/images/ui/search_field/search-history-empty.png
diff --git a/images/ui/search_field/search-history-popup-mes.png b/images/ui/search_field/search-history-popup-mes.png
diff --git a/images/ui/search_field/search-history-popup.png b/images/ui/search_field/search-history-popup.png
diff --git a/images/ui/search_field/search-icon-position-big.png b/images/ui/search_field/search-icon-position-big.png
diff --git a/images/ui/search_field/search-icon-position-small.png b/images/ui/search_field/search-icon-position-small.png
diff --git a/images/ui/search_field/search-no-history.png b/images/ui/search_field/search-no-history.png
diff --git a/images/ui/search_field/search-with-history.png b/images/ui/search_field/search-with-history.png
diff --git a/images/ui/search_field/search_field.png b/images/ui/search_field/search_field.png
diff --git a/images/ui/search_field/search_field_attributes.png b/images/ui/search_field/search_field_attributes.png
diff --git a/images/ui/search_field/search_field_attributes_ccorrect_dark.png b/images/ui/search_field/search_field_attributes_ccorrect_dark.png
diff --git a/images/ui/search_field/search_field_attributes_correct.png b/images/ui/search_field/search_field_attributes_correct.png
diff --git a/images/ui/search_field/search_field_attributes_correct_dark.png b/images/ui/search_field/search_field_attributes_correct_dark.png
diff --git a/images/ui/search_field/search_field_attributes_dark.png b/images/ui/search_field/search_field_attributes_dark.png
diff --git a/images/ui/search_field/search_field_attributes_incorrect.png b/images/ui/search_field/search_field_attributes_incorrect.png
diff --git a/images/ui/search_field/search_field_attributes_incorrect_dark.png b/images/ui/search_field/search_field_attributes_incorrect_dark.png
diff --git a/images/ui/search_field/search_field_clear_search.png b/images/ui/search_field/search_field_clear_search.png
diff --git a/images/ui/search_field/search_field_clear_search_dark.png b/images/ui/search_field/search_field_clear_search_dark.png
diff --git a/images/ui/search_field/search_field_close_icon.png b/images/ui/search_field/search_field_close_icon.png
diff --git a/images/ui/search_field/search_field_close_icon_dark.png b/images/ui/search_field/search_field_close_icon_dark.png
diff --git a/images/ui/search_field/search_field_completion.png b/images/ui/search_field/search_field_completion.png
diff --git a/images/ui/search_field/search_field_dark.png b/images/ui/search_field/search_field_dark.png
diff --git a/images/ui/search_field/search_field_enabled_icons.png b/images/ui/search_field/search_field_enabled_icons.png
diff --git a/images/ui/search_field/search_field_enabled_icons_dark.png b/images/ui/search_field/search_field_enabled_icons_dark.png
diff --git a/images/ui/search_field/search_field_example.png b/images/ui/search_field/search_field_example.png
diff --git a/images/ui/search_field/search_field_hints.png b/images/ui/search_field/search_field_hints.png
diff --git a/images/ui/search_field/search_field_hints_dark.png b/images/ui/search_field/search_field_hints_dark.png
diff --git a/images/ui/search_field/search_field_history.png b/images/ui/search_field/search_field_history.png
diff --git a/images/ui/search_field/search_field_history_dark.png b/images/ui/search_field/search_field_history_dark.png
diff --git a/images/ui/search_field/search_field_label_correct.png b/images/ui/search_field/search_field_label_correct.png
diff --git a/images/ui/search_field/search_field_label_correct_dark.png b/images/ui/search_field/search_field_label_correct_dark.png
diff --git a/images/ui/search_field/search_field_label_incorrect.png b/images/ui/search_field/search_field_label_incorrect.png
diff --git a/images/ui/search_field/search_field_label_incorrect_dark.png b/images/ui/search_field/search_field_label_incorrect_dark.png
diff --git a/images/ui/search_field/search_field_multiline.png b/images/ui/search_field/search_field_multiline.png
diff --git a/images/ui/search_field/search_field_multiline_dark.png b/images/ui/search_field/search_field_multiline_dark.png
diff --git a/images/ui/search_field/search_field_new_line_icon.png b/images/ui/search_field/search_field_new_line_icon.png
diff --git a/images/ui/search_field/search_field_new_line_icon_dark.png b/images/ui/search_field/search_field_new_line_icon_dark.png
diff --git a/images/ui/search_field/search_field_placement.png b/images/ui/search_field/search_field_placement.png
diff --git a/images/ui/search_field/search_field_placement_correct.png b/images/ui/search_field/search_field_placement_correct.png
diff --git a/images/ui/search_field/search_field_placement_correct_dark.png b/images/ui/search_field/search_field_placement_correct_dark.png
diff --git a/images/ui/search_field/search_field_placement_dark.png b/images/ui/search_field/search_field_placement_dark.png
diff --git a/images/ui/search_field/search_field_placement_incorrect.png b/images/ui/search_field/search_field_placement_incorrect.png
diff --git a/images/ui/search_field/search_field_placement_incorrect_dark.png b/images/ui/search_field/search_field_placement_incorrect_dark.png
diff --git a/images/ui/search_field/search_field_project.png b/images/ui/search_field/search_field_project.png
diff --git a/images/ui/search_field/search_field_project_dark.png b/images/ui/search_field/search_field_project_dark.png
diff --git a/images/ui/search_field/search_field_search_options.png b/images/ui/search_field/search_field_search_options.png
diff --git a/images/ui/search_field/search_field_search_options_1.png b/images/ui/search_field/search_field_search_options_1.png
diff --git a/images/ui/search_field/search_field_search_options_1_dark.png b/images/ui/search_field/search_field_search_options_1_dark.png
diff --git a/images/ui/search_field/search_field_search_options_2.png b/images/ui/search_field/search_field_search_options_2.png
diff --git a/images/ui/search_field/search_field_search_options_2_dark.png b/images/ui/search_field/search_field_search_options_2_dark.png
diff --git a/images/ui/search_field/search_field_search_options_3.png b/images/ui/search_field/search_field_search_options_3.png
diff --git a/images/ui/search_field/search_field_search_options_3_dark.png b/images/ui/search_field/search_field_search_options_3_dark.png
diff --git a/images/ui/search_field/search_field_search_options_dark.png b/images/ui/search_field/search_field_search_options_dark.png
diff --git a/images/ui/search_field/search_field_search_replace.png b/images/ui/search_field/search_field_search_replace.png
diff --git a/images/ui/search_field/search_field_search_replace_dark.png b/images/ui/search_field/search_field_search_replace_dark.png
diff --git a/images/ui/search_field/search_field_settings.png b/images/ui/search_field/search_field_settings.png
diff --git a/images/ui/search_field/search_field_tab_focus.png b/images/ui/search_field/search_field_tab_focus.png
diff --git a/images/ui/search_field/search_field_tab_focus_dark.png b/images/ui/search_field/search_field_tab_focus_dark.png
diff --git a/images/ui/search_field/search_field_width.png b/images/ui/search_field/search_field_width.png
diff --git a/images/ui/search_field/structural-replace.png b/images/ui/search_field/structural-replace.png
diff --git a/images/ui/search_field/width-toolbar.png b/images/ui/search_field/width-toolbar.png
diff --git a/topics/ui/controls/search_field.md b/topics/ui/controls/search_field.md
@@ -10,182 +10,96 @@
 
 </tldr>
 
-A search field is an input field that helps users locate objects, actions or text in an application.
+A search field is an [input field](input_field.md) that helps users locate objects, actions, or text.
 
-![](search_field_example.png){width=400}
-
-This article focuses on the search field.
+![](search_field.png){width=706}
 
 [//]: # (TODO: See another article for [search results]&#40;search_results.md&#41;.)
 
 ## When to use
 
-Use the search field when specific objects are difficult to find at a glance, for example:
+Use a search field when specific objects are difficult to find at a glance:
 
-* There are many objects, for example, in the VCS Log table or in the Editor with a large file opened.
-* Objects aren't in a single location, for example controls are located on different setting pages.
+* There are many objects, as in the VCS Log table or in the Editor with a large file opened.
+* Objects aren't in a single location, for example, controls are located on different setting pages.
 
 ## How to use
 
-### Label and Placeholder
-
-Do **not** add a label to the search field. The magnifying glass icon is self-explanatory.
-
-<format color="Red" style="bold">Incorrect</format>
-
-![](ptree-incorrect.png){width=360}
-
-<format color="Green" style="bold">Correct</format>
+### Label
 
-![](ptree-correct.png){width=360}
+Don't add a label <control>Search</control> to the search field. The magnifying glass icon is self-explanatory.
 
-Mark the replace field with a label or a placeholder when shown together with the search field to distinguish between them:
-
-![](structural-replace.png){width=865}
+<table style="none" border="false">
+    <tr>
+        <td><format style="bold" color="Green">Correct</format><img src="search_field_label_correct.png" width="378"/></td>
+        <td><format style="bold" color="Red">Incorrect</format><img src="search_field_label_incorrect.png" width="378"/></td>
+    </tr>
+</table>
 
-Provide hints and scope as placeholder text.
-For example, the placeholder for plugins' search depends on the settings page tab to make it clear that search depends on the tab:
+### Placeholder
 
-![](placeholder.png){width=581}
+Provide hints such as search scope as placeholder text.
 
-### Icons
+![](search_field_hints.png){width=706}
 
-#### Search Options
+### Search and Replace fields
 
-Use icon buttons inside the search field to save space and not to overload the UI and to be able to use them in already packed UI such as the Speed Search popup in trees or lists:
+Mark the Search and Replace fields with placeholders when shown together to distinguish between them:
 
-![](options.png){width=400}
+![](search_field_search_replace.png){width=706}
 
-Available option icons:
+### Search options
 
-| ![](matchCase.png){width=16}   | Match case   |
-|--------------------------------|--------------|
-| ![](regex.png){width=16}       | Regex        |
-| ![](words.png){width=16}       | Words        |
-| ![](inSelection.png){width=16} | In selection |
-{style=none}
+Use [icon buttons](icon_button.md) inside the search field to save space and not to overload the UI.
 
-Change the state of options icons on hover so that it is clear that they are clickable:
+![](search_field_search_options.png){width="706"}
 
-![](options-hovered.png){width=400}
+Icon buttons should change background color when enabled so that it is clear which options are currently enabled.
 
-Make icon buttons easily accessible with Tab navigation.
-Option icons should be placed on the right of the search field in the tabbing order.
-Show a border around the focused option.
+![](search_field_enabled_icons.png){width=706}
 
-![](options-focused.png){width=400}
+### Tab navigation
 
-Icon buttons should change color when enabled so that it is clear which options are currently enabled:
+Make icon buttons easily accessible with <control>Tab</control>. Focused button should have a colored border.
 
-![](options-on.png){width=400}
+![](search_field_tab_focus.png){width=706}
 
-#### Clear a Search String
+### Clear a Search String
 
-Show the clear button <icon src="../../../images/ui/search_field/icons/clear-light.png" /> only when filtering on-screen content.
+Show the <control>Clear</control> button <icon src="../../../images/ui/search_field/search_field_close_icon.png" width="20"/> when the search field has been filled.
 When the button is clicked, clear the search field and restore the content to its default state.
-Do **not** show the clear button if the search field is empty.
-
-![](clear-search-correct.png){width=581}
-
-Do **not** show the clear button when the initial data state is empty or doesn't differ from the result.
-For example, the close icon is not really useful in the editor search field since matches are highlighted and not filtered:
 
-<format color="Red" style="bold">Incorrect</format>
-
-![](clear-search-incorrect.png){width=419}
+![](search_field_clear_search.png){width=706}
 
 When search can be configured with options, show the clear button on the left of the option buttons.
 This way, option buttons won't jump when the clear button appears.
-The separator between the options and the clear button makes it harder to mis-click the potentially dangerous clear icon.
-
-![](search_field_example.png){width=400}
-
-#### Multiline Search Strings
-
-Searching for multiline matches can be achieved with a separate New Line action button:
 
-![](new-line.png){width=342}
+![](search_field.png){width=706}
 
-Put the New line action button on the left of the option buttons:
+### Multiline search strings
 
-![](newline-options.png){width=300}
+If multiline search is needed, use the New Line <icon src="../../../images/ui/search_field/search_field_new_line_icon.png" width="16"/> action button. It should be placed on the left of the rest of the search options.
 
-Move the New Line action button below the option buttons when the search field becomes a multi-line one:
+![](search_field_multiline.png){width=706}
 
-![](multiline.png){width=300}
+The default shortcut for the New Line action: <shortcut>⇧⌘⏎</shortcut> for macOS and <shortcut>Ctrl + Shift + Enter</shortcut> for Windows/Linux.
 
-Add a vertical separator when the scrollbar appears:
+### Filters
 
-![](multiline-scrollbar.png){width=300}
+Provide filters for complex searches. Don't use filter attributes in the search query.
 
-The default shortcut for the New Line action:
-
-<table style="header-column">
-  <tr>
-    <td>macOS</td>
-    <td><shortcut>⇧⌘⏎</shortcut></td>
-  </tr>
-  <tr>
-     <td>Windows/Linux</td>
-     <td><shortcut>Ctrl + Shift + Enter</shortcut></td>
-  </tr>
+<table style="none" border="false">
+    <tr>
+        <td><format style="bold" color="Green">Correct</format><img src="search_field_attributes_correct.png" width="378"/></td>
+        <td><format style="bold" color="Red">Incorrect</format><img src="search_field_attributes_incorrect.png" width="378"/></td>
+    </tr>
 </table>
 
-### Completion
-
-Provide completion for complex searches with filtering by attributes:
-
-![](search_field_completion.png){width=354}
-
-Do **not** use filter attributes as separate controls on the toolbar.
-Not all of them are needed every time while they take a lot of space and overload the interface.
-Use completion instead:
-
-<format color="Red" style="bold">Incorrect</format>
-
-![](filters-incorrect.png){width=550}
-
-<format color="Green" style="bold">Correct</format>
-
-![](filters-correct.png){width=550}
-
-The following syntax is used for attributes:
-
-* Binary attributes are marked with a number sign (#), for example, _#by-jetbrains_ to show plugins which are developed by JetBrains.
-
-* Values for open attributes are provided after a colon, for example, _status: disabled_ to show all disabled plugins.
-
-Provide aliases to the main attributes where possible, this way it would be easier for users to find the required filter.
-For example, the User attribute in the VCS Log search field can have the Author alias.
-
-Show a popup with search attributes when the field gets focus, and after each space character except the space character following an attribute's name.
-This will make it clear that filtering by attributes is available.
-
-Filter out the completion suggestions as the user types:
-
-![](completion-filtered.png){width=354}
-
-Show a popup with values right after the user has entered an attribute.
-
-![](completion-variants.png){width=354}
-
-### Search History
-
-Use the magnifying glass icon with an arrow when search history is available:
-
-![](search-with-history.png){width=250}
+### Search history
 
-And without an arrow when it's not:
+Use the magnifying glass icon with an arrow when search history is available. Show search history in a popup when clicking on the magnifying glass icon.
 
-![](search-no-history.png){width=250}
-
-Show search history in a popup when clicking on the magnifying glass icon:
-
-![](search-history-popup.png){width=256}
-
-Show context help in the history popup when it is empty:
-
-![](search-history-empty.png){width=256}
+![](search_field_history.png){width=706}
 
 The keyboard shortcut for the History action is <shortcut>Alt + Down</shortcut> on all systems.
 
@@ -198,98 +112,44 @@ Add a search string to history:
 
 ### Placement
 
-Put the search field on top of the on-screen content that is being searched, and align them vertically.
-For example, the search field in <control>Settings</control> dialog is aligned with the filtered settings tree:
-
-<format color="Green" style="bold">Correct</format>
-
-![](search_field_settings.png){width=256}
-
-The search field is not aligned with the content on the Keymap settings page, which makes it harder to relate the content and the search string:
-
-<format color="Red" style="bold">Incorrect</format>
+Put the search field on top of the content that is being searched and align them vertically.
+For example, the search field in <control>Settings</control> dialog is aligned with the filtered settings tree.
 
-![](keymap-search-incorrect.png){width=491}
+![](search_field_placement.png){width=706}
 
-<format color="Green" style="bold">Correct</format>
+<!-- #### Inline search
 
-![](keymap-search-correct.png){width=491}
+Fit the search field to a popup window or to a toolbar if it has top borders. This way the overall form looks less complex.
 
-Fit the search field to the popup windows and to a toolbar if it has top borders. This way the overall form looks less complex.
+<table style="none" border="false">
+    <tr>
+        <td><format style="bold" color="Green">Correct</format><img src="search_field_placement_correct.png" width="378"/></td>
+        <td><format style="bold" color="Red">Incorrect</format><img src="search_field_placement_incorrect.png" width="378"/></td>
+    </tr>
+</table> -->
 
-<format color="Red" style="bold">Incorrect</format>
+#### Speed Search
 
-![](log-incorrect.png){width=475}
+Show the search field on demand when search is supplementary to other functionality or if space is limited. The search field should be accessible with <shortcut>cmd+F</shortcut> on macOS and <shortcut>Ctrl + F</shortcut> on Windows/Linux.
+For example, space in the Project view is limited and too loaded to always show the Search bar:
 
-<format color="Green" style="bold">Correct</format>
-
-![](log-correct.png){width=475}
-
-| <format color="Red" style="bold">Incorrect</format> | <format color="Green" style="bold">Correct</format> |
-|-----------------------------------------------------|-----------------------------------------------------|
-| ![](popup-incorrect.png){width="235"}               | ![](popup-correct.png){width="235"}                 |
-
-Show the search field on demand when search is supplementary to other functionality or if space is limited.
-For example, space in the Project view is limited and too loaded to always show the _Speed Search_ bar:
-
-![](ptree-correct.png){width=360}
-
-When searching through content that is not displayed on the screen, put the search field on top of the active frame as a popup.
-This makes it more prominent and gives space for search results.
-For example, Search Everywhere is shown on top of the main IDE frame:
-
-![](search-everywhere.png){width=686}
+![](search_field_project.png){width=706}
 
 ### Sizes
 
-For a search field shown without a toolbar (i.e. _Speed Search_ in trees), the search width could be adjusted on typing to accommodate input:
-
-![](search_field_width.png){width=160}
-
-For a search field that is not fitted to a toolbar, set the minimum width to 200:
-
-![](width-toolbar.png){width=425}
-
-For a search which is fitted to the toolbar, expand the field to the toolbar width.
-
-Center-align icons and the search string with the one-line search field vertically. Adjust the right and left paddings to the higher search fields:
-
-![](search-icon-position-small.png){width=297}
-
-![](search-icon-position-big.png){width=296}
-
-Save the position of the search and option icons when the search field becomes a multi-line one:
-
-![](multiline-mes.png){width=250}
-
-### Spaces
-
-Between the floating search field and on-screen content:
-
-![](ptree-sizes.png){width=265}
-
-Between history and the search field:
-
-![](search-history-popup-mes.png){width=269}
-
-Between search string and completion popup:
-
-![](completion-mes-2.png){width=266}
-
-Completion popup:
-
-![](completion-mes.png){width=95}
+#### Grouped with other controls {#grouped-search-size}
 
-## Style
+For a search field which is displayed as an input field in a group of controls, for example, in a tool window toolbar, follow the [input sizes guideline](input_field.md#sizes-and-placement).
 
-### Colors and Fonts
+#### Above lists and trees {#list-trees-search-size}
 
-For a general search field, use the same colors as for an input field.
+When placed above lists or trees, expand the field to the width of the list or tree.
 
-For a search field that is fitted to the toolbar, use a narrower focus border on macOS. The border width is 2px in that case:
-![](log-focused.png){width=475}
+#### Speed search {#speed-search-size}
 
-Use the same font for the search string as used for showing the results.
+For a search field shown on demand, for example, in the <control>Project</control> tool window, expand the field to the width of the tool window.
 
-Use the Context help font color for the attributes' names as they are secondary to their values.
+<!-- #### In a toolbar {#toolbar-search-size}
 
+* For a search field shown without a toolbar, for example, Search in trees, the search width could be adjusted on typing to accommodate input.
+* For a search field that is not fitted to a toolbar, set the minimum width to 200 px. -->