Skip to contentSkip to navigationSkip to topbar
On this page
Looking for more inspiration?Visit the
(information)
You're in the right place! Segment documentation is now part of Twilio Docs. The content you are used to is still here—just in a new home with a refreshed look.

CommandBar Destination


CommandBar(link takes you to an external page) 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 documentation.


Getting started

getting-started page anchor
  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(link takes you to an external page), 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).

Property nameTypeRequiredDescription
Deploy via Segmentboolean

Optional

If enabled, CommandBar will be deployed to your site automatically and you can remove the snippet from your source code.


Organization IDstring
required

The ID of your CommandBar organization.


CommandBar has the following presets

Preset NameTriggerDefault Action
Track EventEvent type = "track"Track Event
Identify UserEvent type = "identify"Identify User

Build your own Mappings. Combine supported triggers with the following CommandBar-supported actions:

(information)

Mapping limits per destination

Individual destination instances have support a maximum of 50 mappings.

Track Event

track-event page anchor

Submit an event's properties as CommandBar metaData.

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

Property nameTypeRequiredDescription
Event NameSTRING
required

The name of the event.


Event MetadataOBJECT

Optional

Optional metadata describing the event.

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"

Property nameTypeRequiredDescription
User IDSTRING
required

The user's id


HMACSTRING

Optional

Identify users with an HMAC of their user ID; this enables end user customizable shortcuts and other features. Learn about identity verification(link takes you to an external page).


Event MetadataOBJECT

Optional

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.


TraitsOBJECT

Optional

The Segment traits to be forwarded to CommandBar