---
title: NSStatusBar
framework: appkit
role: symbol
role_heading: Class
path: appkit/nsstatusbar
---

# NSStatusBar

An object that manages a collection of status items displayed within the system-wide menu bar.

## Declaration

```swift
class NSStatusBar
```

## Overview

Overview A status item (an instance of NSStatusItem) can be displayed with text or an icon, can provide a menu and a target-action message when clicked, or can be a fully customized view that you create. Use status items sparingly and only if the alternatives (such as a Dock menu, preference pane, or status window) are not suitable. Because there is limited space in which to display status items, status items are not guaranteed to be available at all times. For this reason, do not rely on them being available and always provide a user preference for hiding your application’s status items to free up space in the menu bar.

## Topics

### Getting the System-Wide Instance

- [system](appkit/nsstatusbar/system.md)

### Managing Status items

- [statusItem(withLength:)](appkit/nsstatusbar/statusitem(withlength:).md)
- [removeStatusItem(_:)](appkit/nsstatusbar/removestatusitem(_:).md)

### Getting Status-Bar Attributes

- [isVertical](appkit/nsstatusbar/isvertical.md)
- [thickness](appkit/nsstatusbar/thickness.md)

### Constants

- [Status Bar Item Length](appkit/status-bar-item-length.md)

## Relationships

### Inherits From

- [NSObject](objectivec/nsobject-swift.class.md)

### Conforms To

- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)

## See Also

### Menu Bar Items

- [NSStatusItem](appkit/nsstatusitem.md)
- [NSStatusBarButton](appkit/nsstatusbarbutton.md)