# CommandBar Destination

[CommandBar](https://www.commandbar.com) gives your users a searchable index of your app's features and content, as well as customizable in-app components, like onboarding nudges. This helps you to better understand user intent and deliver step-change improvements in UX, for new and power users alike. By connecting Segment to CommandBar as a destination, you can trigger nudges and customize CommandBar functionality based on user events and user attributes. The integration also allows you to deploy CommandBar to your users.

To configure CommandBar as an Event Source to get data into your warehouse or other downstream tools, see the [CommandBar Source](/docs/segment/connections/sources/catalog/cloud-apps/commandbar/) documentation.

## Getting started

1. From the Segment web app, navigate to **Connections > Catalog**, then select the **Destinations** tab at the top of the catalog.
2. Search for *CommandBar* and select it.
3. Click **Configure CommandBar**.
4. Sign in to [CommandBar](https://app.commandbar.com/login), click on your organization name in the top right, and copy the `Org ID` into **Organization ID** field.
5. If you want to deploy CommandBar to your users through Segment, check **Deploy via Segment**.
6. Select an existing Source to connect to CommandBar.
7. Once connected, remove the CommandBar snippet or `init` call from your code (if you have one).

## Destination Settings

| Field              | Description                                                                                                              | Required | Type    |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------ | -------- | ------- |
| Deploy via Segment | If enabled, CommandBar will be deployed to your site automatically and you can remove the snippet from your source code. | No       | boolean |
| Organization ID    | The ID of your CommandBar organization.                                                                                  | Yes      | string  |

## Available Presets

CommandBar has the following presets

| Preset Name   | Trigger                 | Default Action |
| ------------- | ----------------------- | -------------- |
| Track Event   | Event type = "track"    | Track Event    |
| Identify User | Event type = "identify" | Identify User  |

## Available Actions

Build your own Mappings. Combine supported [triggers](/docs/segment/connections/destinations/actions/#components-of-a-destination-action) with the following CommandBar-supported actions:

> \[!NOTE]
>
> Individual destination instances have support a maximum of 50 mappings.

* [Track Event](#track-event-34)
* [Identify User](#identify-user-21)

### Track Event

Submit an event's properties as CommandBar metaData.

Track Event is a **Web** action. The default Trigger is `type = "track"`

| Field          | Description                             | Required | Type   |
| -------------- | --------------------------------------- | -------- | ------ |
| Event Name     | The name of the event.                  | Yes      | STRING |
| Event Metadata | Optional metadata describing the event. | No       | OBJECT |

### Identify User

Set attributes for the user in CommandBar. If "Deploy via Segment" is enabled, then also boot CommandBar for the user, which makes CommandBar available to the user.

Identify User is a **Web** action. The default Trigger is `type = "identify"`

| Field          | Description                                                                                                                                                                                             | Required | Type   |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------ |
| User ID        | The user's id                                                                                                                                                                                           | Yes      | STRING |
| HMAC           | Identify users with an HMAC of their user ID; this enables end user customizable shortcuts and other features. \[Learn about identity verification]\(https://app.commandbar.com/identity-verification). | No       | STRING |
| Event Metadata | Configures the way the bar is displayed. An 'inline' bar is always visible and hosted within an element on your page. A 'modal' bar will display in a modal dialog when open.                           | No       | OBJECT |
| Traits         | The Segment traits to be forwarded to CommandBar                                                                                                                                                        | No       | OBJECT |