---
title: NSSearchToolbarItem
framework: appkit
role: symbol
role_heading: Class
path: appkit/nssearchtoolbaritem
---

# NSSearchToolbarItem

A toolbar item that contains a search field optimized for performing text-based searches.

## Declaration

```swift
class NSSearchToolbarItem
```

## Overview

Overview NSSearchToolbarItem automatically resizes to accommodate typing when the focus switches to the toolbar item. When the toolbar is low on space, the system may collapse the search item into a button representation, which then expands to a full search field when the user clicks on it.

## Topics

### Configuring a search item

- [preferredWidthForSearchField](appkit/nssearchtoolbaritem/preferredwidthforsearchfield.md)
- [resignsFirstResponderWithCancel](appkit/nssearchtoolbaritem/resignsfirstresponderwithcancel.md)
- [searchField](appkit/nssearchtoolbaritem/searchfield.md)

### Controlling search interactions

- [beginSearchInteraction()](appkit/nssearchtoolbaritem/beginsearchinteraction().md)
- [endSearchInteraction()](appkit/nssearchtoolbaritem/endsearchinteraction().md)

## Relationships

### Inherits From

- [NSToolbarItem](appkit/nstoolbaritem.md)

### Conforms To

- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [NSCopying](foundation/nscopying.md)
- [NSMenuItemValidation](appkit/nsmenuitemvalidation.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)
- [NSValidatedUserInterfaceItem](appkit/nsvalidateduserinterfaceitem.md)
- [Sendable](swift/sendable.md)
- [SendableMetatype](swift/sendablemetatype.md)

## See Also

### Items

- [NSToolbarItem](appkit/nstoolbaritem.md)
- [NSToolbarItemGroup](appkit/nstoolbaritemgroup.md)
- [NSToolbarItemGroup.ControlRepresentation](appkit/nstoolbaritemgroup/controlrepresentation-swift.enum.md)
- [NSToolbarItemGroup.SelectionMode](appkit/nstoolbaritemgroup/selectionmode-swift.enum.md)
- [NSMenuToolbarItem](appkit/nsmenutoolbaritem.md)
- [NSTrackingSeparatorToolbarItem](appkit/nstrackingseparatortoolbaritem.md)