Importing User Attributes or Tags

Upload a list of Data Tags to Users.

This feature allows you to add, remove, and update data tags from device records and create segments using a CSV.

This feature does not import or transfer devices into OneSignal or across OneSignal apps. See Onboarding With OneSignal for more on importing or transferring devices.


Migrating or Importing Devices to OneSignal?

See our Onboarding With OneSignal guide for more details on importing device records.

OneSignal doesn't provide an option to transfer users from one app to another. Please reach out to our Support Team with more details on your use case.


Importing Email Addresses or Phone Numbers?

See Import Email Addresses guide or Import Phone Numbers guide.

How to do I upload user tags?

  1. Navigate to Audience > All Users
  2. Select Actions > Import/Update Users

shows the 'Update/Import Users' button to select from

  1. From the pop-up menu select Upload CSV next to Update Users.
  1. Navigate to your CSV and select it to begin the upload

  2. You will now see a preview of the import where you can do the following:

    • Decide to turn on/off certain tag columns from being imported
    • Automatically create a segment of the import (will add a tag and create the segment with the tag name)
    • Decide to delete tags if values are empty within the record's row
  3. Once you Confirm and Import you will get an email stating your CSV Import has finished.



What tier do I need to be on?

This is a Paid OneSignal Account. This is not available for Free tiered customers.

CSV file with a player_id and/or external_user_id columnIf using external_user_id it must be set within OneSignal already. See Onboarding With OneSignal
CSV restrictions- Must have player_id and/or external_user_id column and spelled correctly
- Must be comma separated values (,)
- Cannot use semi-colons ; or JSON
- Must remove quotes (", ')

What Format should my CSV be in?

  • The first row must have player_id and/or external_user_id as columns. Please ensure you spell these correctly.
  • Do not use quotes around any parameters. Please remove all quote marks.
  • Parameters must be separated by commas. Semi-colons do not work.

Example Format: