You can define your audience based on tags, tag groups, named users, and Airship channel IDs.

Addressing Devices

To help target specific devices or users for a notification, we have Tags, Named Users, and Tag Groups.


Tags allow you to attribute arbitrary metadata to a specific device. Common examples include favorites such as sports teams or news story categories.

Setting tags
// Set tags
UrbanAirship.tags = ["some-tag", "other-tag"];

Named Users

Named Users allow you to associate multiple devices to a single user or profile that may be associated with more than one device, e.g., an end-user’s tablet and phone. A device can have only one Named User, and a single Named User should not be associated with more than 50 devices. Named Users provide the ability to directly set tags on them.

By default, Named Users can only be associated server-side. A 403 Forbidden response is returned if Named User association is attempted when client-side association is disabled. In order to associate a Named User through the application, you must change the application’s Named User security setting to allow Named Users to be set from devices. See: Enable Named Users.


Associating the channel with a Named User ID will implicitly disassociate the channel from the previously associated Named User ID, if an association existed.

Associating a named user
UrbanAirship.namedUser = "coolNamedUserId"
Dissociating a named user
UrbanAirship.namedUser = null

Airship Channel IDs

The Channel ID is a unique identifier that ties together an application/device pair on a mobile device. The Channel ID is used to target pushes to specific devices using the Airship API. Once a Channel ID is created, it will persist in the application. It may or may not change when the application is reinstalled. For more information on platform-specific operation, see the Android and iOS documentation.

Don’t worry if this value initially comes back as null on your app’s first run (or after clearing the application data), as the Channel ID will be created and persisted during registration. To receive an event when the Channel ID is created, see Listening for Events.

Getting the Channel ID
var channelId = UrbanAirship.channelId;