---
title: "addItem(withTitle:action:keyEquivalent:)"
framework: appkit
role: symbol
role_heading: Instance Method
path: "appkit/nsmenu/additem(withtitle:action:keyequivalent:)"
---

# addItem(withTitle:action:keyEquivalent:)

Creates a new menu item and adds it to the end of the menu.

## Declaration

```swift
func addItem(withTitle string: String, action selector: Selector?, keyEquivalent charCode: String) -> NSMenuItem
```

## Parameters

- `string`: A string to be made the title of the menu item.
- `selector`: The action-message selector to assign to the menu item.
- `charCode`: A string identifying the key to use as a key equivalent for the menu item. If you do not want the menu item to have a key equivalent, keyEquiv should be an empty string (@"") and not nil.

## Return Value

Return Value The created menu item (an object conforming to the NSMenuItem protocol) or nil if the object couldn’t be created.

## See Also

### Adding and Removing Menu Items

- [insertItem(_:at:)](appkit/nsmenu/insertitem(_:at:).md)
- [insertItem(withTitle:action:keyEquivalent:at:)](appkit/nsmenu/insertitem(withtitle:action:keyequivalent:at:).md)
- [addItem(_:)](appkit/nsmenu/additem(_:).md)
- [removeItem(_:)](appkit/nsmenu/removeitem(_:).md)
- [removeItem(at:)](appkit/nsmenu/removeitem(at:).md)
- [itemChanged(_:)](appkit/nsmenu/itemchanged(_:).md)
- [removeAllItems()](appkit/nsmenu/removeallitems().md)