# Field Buttons

Field buttons are another special type of button. They are used to place field controls (for example, the location fields) on your toolbars. In Customize mode they appear as a simple frame which you can resize by clicking and dragging the border.

![](https://3597805814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3XSZSwWow0fDf6fQJobd%2Fuploads%2Fgit-blob-453ee702b3fe452d5ba0a0ecdbc9863b3c34b358%2Ffield_buttons_-_customize.png?alt=media)

The above image shows the search field from the default Menu toolbar and the location field from the default File Display Border toolbar. You can see that the search field has grab handles at the right-hand edge, which let you resize the field. The location field does not, because it is set to _Full Width_ mode, meaning it will expand to fill all available space on the toolbar.

Once we leave Customize mode you can see that the frames revert to fully functional fields:

![](https://3597805814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3XSZSwWow0fDf6fQJobd%2Fuploads%2Fgit-blob-f751bef2f45c5be0443b57a2c7e8185426f6ca2b%2Ffield_buttons_-_no_customize.png?alt=media)

Note that the compatibility files button disappeared when leaving Customize mode; this is because when the screenshot was taken the Lister was not currently displaying a folder that has compatibility files, and so the button was automatically hidden. You'll find that many buttons on Opus toolbars can change their state (checked or unchecked, enabled or disabled, hidden or shown) dynamically. If we had navigated to _C:\Program_ Files before taking the screenshot the compatibility files button would have been visible.

Field buttons are the only type of button that you can't create manually (by starting with a new button). To add a field button to a toolbar you have to find its entry in the list on the **Commands** page and drag it to the toolbar. Once it is on the toolbar, however, you can change what type of field it is as well as configure certain properties by right-clicking it when in Customize mode.

![](https://3597805814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3XSZSwWow0fDf6fQJobd%2Fuploads%2Fgit-blob-10aa2164fc8bf2ff499dfc4575e7de872df91a47%2Ffield_buttons_edit.png?alt=media)

The context menu for a field button lets you configure two options that only apply to fields:

* **Full Width**: If this option is enabled, the field will use all the available space on the toolbar (that is, any space that's not used by another button). If two or more fields on the same toolbar have this flag set, they will share the available space.
* **Restore Focus**: If this option is enabled, pressing the **Enter** key in the field will return focus automatically to the file display.

The **Field Type** sub-menu lets you switch between the various types of field:

*   **Content Type**: If folder [content type detection](../../../basic_concepts/folder_options/content_types) is enabled, displays the current content type format in use. You can also use the drop-down list to instantly switch to one of the defined content type formats.

    ![](https://3597805814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3XSZSwWow0fDf6fQJobd%2Fuploads%2Fgit-blob-c87e5db9ecea5c80fca785dee5b7bddc8e008c2f%2Fcontent_type_field.png?alt=media)
*   **Drives**: The [Drive List](../../../basic_concepts/the_lister/navigation/drive_buttons_and_lists) field is drop-down list of your disk drives. Selecting a drive from the list navigates the source file display to that location.

    ![](https://3597805814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3XSZSwWow0fDf6fQJobd%2Fuploads%2Fgit-blob-6dfcc01a8c289037b46c77ad060bee66925c66fa%2Fdrive_list_field.png?alt=media)
*   **Filter**: The [filter field](../../../basic_concepts/searching_and_filtering/toolbar_filter_fields) lets you filter the items visible in the current folder by entering a [wildcard pattern](../../../reference/wildcard_reference/pattern_matching_syntax).

    ![](https://3597805814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3XSZSwWow0fDf6fQJobd%2Fuploads%2Fgit-blob-d9d07e66f0a1a8f95849b927c9b12f4bf5415980%2Ffilter_field.png?alt=media)
*   **Label:** A label field has no function other than to display a static label. You can use it to provide a label for other controls or just to display a static text string on a toolbar.

    Label fields in drop-down menus are drawn in a bold font and left-aligned to stand out visually from the other items in the menu.

    ![](https://3597805814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3XSZSwWow0fDf6fQJobd%2Fuploads%2Fgit-blob-2e3ed8bafb87708e5af783731abb91acebe5b2f1%2Fimage079.png?alt=media)
*   **Path (Basic)**: The basic path (location) field is a minimalist text field that displays the current path and lets you type a new path to navigate in the Lister. By default this field controls the current source file display, but you can [configure](field_buttons/path_field_configuration) it to specify the display it is linked to.

    ![](https://3597805814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3XSZSwWow0fDf6fQJobd%2Fuploads%2Fgit-blob-a5a6c21405d37ed79022b06ab669b4a19879efb6%2Fpath_field_basic.png?alt=media)
*   **Path (Breadcrumbs)**: The [breadcrumbs](../../../basic_concepts/the_lister/navigation/file_display_border/breadcrumbs_location_field) path (location) field is a powerful navigation tool that provides instant access to prior locations in the current path. This field has [lots of configurable options](../../../preferences/preferences_categories/location_bar/path_fields) that can modify its appearance and behaviour.

    ![](https://3597805814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3XSZSwWow0fDf6fQJobd%2Fuploads%2Fgit-blob-dc69a7434fbf4f0d6ca55c7af3d639e176832d5c%2Fpath_field_crumbs.png?alt=media)
*   **Path (Favorites List)**: The favorites list path field combines the basic path field with a drop-down menu of your [favorite folders](../../../basic_concepts/the_lister/navigation/favorites), which you can navigate to by selecting them from the drop-down. By default this field controls the current source file display, but you can [configure](field_buttons/path_field_configuration) it to specify the display it is linked to.

    ![](https://3597805814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3XSZSwWow0fDf6fQJobd%2Fuploads%2Fgit-blob-8a0292a1975bd6390d27b4d6d3e99bc93464caa9%2Fpath_field_dropdown.png?alt=media)
*   **Path (Folder Tree)**: The folder tree path field combines the basic path field with a drop-down list containing the folder tree hierarchy leading to the current location. This lets you navigate to previous folders in the tree from the drop-down. By default this field controls the current source file display, but you can [configure](field_buttons/path_field_configuration) it to specify the display it is linked to.

    ![](https://3597805814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3XSZSwWow0fDf6fQJobd%2Fuploads%2Fgit-blob-8a0292a1975bd6390d27b4d6d3e99bc93464caa9%2Fpath_field_dropdown.png?alt=media)
*   **Path (Recent List)**: The recent list path field combines the basic path field with a drop-down menu of your [recently visited folders](../../../basic_concepts/the_lister/navigation/recent_and_history_lists). By default this field controls the current source file display, but you can [configure](field_buttons/path_field_configuration) it to specify the display it is linked to.

    ![](https://3597805814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3XSZSwWow0fDf6fQJobd%2Fuploads%2Fgit-blob-8a0292a1975bd6390d27b4d6d3e99bc93464caa9%2Fpath_field_dropdown.png?alt=media)
*   **Search Field**: The search field lets you search the current folder using the indexed [Windows Search](../../../basic_concepts/searching_and_filtering/windows_search) system.

    ![](https://3597805814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3XSZSwWow0fDf6fQJobd%2Fuploads%2Fgit-blob-96425a7d26543589c1fcbaf4833fb748053aa9f3%2Fsearch_field1.png?alt=media)
* **Spacer**: A spacer field has no function other than to take up room on the toolbar - it's used to right-justify toolbar elements.
*   **Thumbnail Size**: The thumbnail size field lets you dynamically resize thumbnails in the current folder. It will be hidden when the Lister is not in thumbnail mode.

    ![](https://3597805814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3XSZSwWow0fDf6fQJobd%2Fuploads%2Fgit-blob-175c1d54e2740f86afc3ba8fe985b401be255626%2Fthumbnail_size_slider.png?alt=media)

    By default, the slider affects all folder tabs in the window if it's on a normal toolbar, and just the side it's over if it's on a Location Bar toolbar. You can change this by editing the field and adding `both`, `source`, `dest`, `left`, or `right` to the _Args_ string. (`both` differs from the default in that it only affects the visible tabs, not inactive ones.)

    By default the slider will set the thumbnail size using the aspect ratio configured in Preferences; however, if you edit the field and add `preserve` to the _Args_ string, it will preserve the current aspect ratio (this would only be useful if the aspect ratio has been changed manually using the `Set THUMBNAILSIZE` command). If a side is also specified, put a comma between the two arguments; e.g. `left,preserve`.

See the [Editing The Toolbar](field_buttons) section for more information on how to edit toolbar fields.

More:

[Path Field Configuration](field_buttons/path_field_configuration)\
[Breadcrumbs Configuration](../../../preferences/preferences_categories/location_bar/path_fields)\
[Filter Field Configuration](field_buttons/filter_field_configuration)\
[Drive List Configuration](field_buttons/drive_list_configuration)
