Upload Attributes By CSV

Set audience attributes by uploading a CSV file, either from the Airship dashboard or using SFTP.

After you add AttributesMetadata that you can use to group and target your audience. Attributes differ from tags in that when evaluating users with attributes, Airship uses operators, e.g., equals, less than/greater than, contains, before/after, to determine whether or not to target a user. Supported attribute types are TEXT, NUMBER, and DATE. to your project, you set the attributes on ChannelsAn instance representing an entity addressable via the Airship service, e.g., an iOS device, email address, SMS number or web browser. The channel instance or channel object contains all relevant information about a channel, including metadata used for targeting, opt-in status, device-specific information, and, importantly, a unique identifier for the channel, the channel ID. or Named UsersA customer-provided identifier used for mapping multiple devices and channels to a specific individual. . In addition to our SDK and API methods, now you can set attributes without needing developer resources. Export audience attributes from your internal data sources and upload the list directly to Airship.


  1. Go to Audience » Attributes » Upload Attribute Data.
  2. Click Choose file and select your CSV.
  3. Click Upload.

SFTP: You can set up any client to use Airship’s SFTP interface, and many CRM platforms natively support SFTP.

  1. Generate a secure key for Airship.
  2. Connect via SSH, or configure your SFTP client’s host, port, and authentication settings.

Your dashboard and SFTP uploads are listed in Audience » Attributes » Upload History.

CSV Data and Format

The fields in your CSV depend on the type of audience you want to upload. You can upload lists for channels, named users, email addresses, or MSISDNs, but you cannot mix identifiers.

When using email or SMS identifiers in your CSV file, Airship registers new channels for addresses or MSISDN/sender combinations that are new to your project. Additional fields indicate opt-in statuses, so that you can send messages to new channels generated from your CSV upload.