Typically, users are added to OneSignal via the OneSignal SDK that is on your mobile app or website. In certain circumstances, you may also want to manually add users or user data to OneSignal. The ability to import users data will depend on the type of subscription and platform the user uses:
Data Required for Push Notifications
You cannot import devices without the device having a push token associated with the record. A Push Token is generated through the website or mobile app when the user subscribes.
Phone number, email address, IP address are not enough information to target a user for push.
Due to the way Web Push is setup by the browsers, you cannot directly migrate subscriber data from a different push provider to OneSignal. However, if your site is HTTPS and you can add files to your server, then there is a way to silently resubscribe users to OneSignal when they return to the site.
- You must have an HTTPS site
- Your users must be subscribed to the same origin/site currently (not a provided subdomain)
- You must be able to add files to your server (cannot select "My site is not fully https" in the OneSignal dashboard)
Then those previously subscribed users will be automatically resubscribed upon returning to your site with OneSignal installed properly.
1 - Remove all your previous Push Provider's code from your site. Including their service workers.
IMPORTANT: Make sure to select the Auto-Resubscribe within the setup configuration. It should be selected for you automatically.
3 - Test your site to make sure you can subscribe and show up in the OneSignal Dashboard. See Troubleshooting Web Push if you are having issues. Then you can continue to send push notifications from your previous push provider to current subscribers. Upon revisiting your site, your subscribed users will now show up in your OneSignal Dashboard and will not be able to get notifications from the previous provider, so no duplicates will occur.
Before migrating, we recommend updating your app to have the OneSignal SDK. This way no users will be lost between the time you migrate your current subscribers and the time you update your app.
iOS - In the case of iOS devices, these subscribers can be imported, however some features like monitoring notification click rate wont work for devices with an old version of your app.
Android - In the case of Android devices, these subscribers can be imported, however they will not be able to receive notifications until they update to a version of your app with the OneSignal SDK. Therefore it's usually not beneficial to import them since they would get added to OneSignal after they updated and opened your app anyway.
If you are using another Mobile Push vendor, devices can be imported into OneSignal through our add device API.
If you need to bulk import 300,000 devices or more contact support providing a .csv file and we will import them over the next few days.
If you have under 300,000 devices and would like them imported, this will require a Paid Plan.
OneSignal supports automatically importing devices from Urban Airship. To access the Import Users page, go to App Settings and select the Import Users From Another Service tab.
When Android devices are imported from Urban Airship they will not be able to receive notifications until they update to a version of your app with the OneSignal SDK. Therefore it's usually not beneficial to import them since they would get added to OneSignal after they updated and opened your app anyway.
Email subscribers may be imported in two ways: CSV upload, or manually adding.
We support uploading a list of email addresses via CSV. Click IMPORT/EXPORT -> Import/Update Users -> SELECT CSV TO UPLOAD Make sure you have an email field in the CSV file. All other fields will be added as tags.
CSV Email Upload
- Must have email column
- Limited to UTF-8 Encoding
- Columns must be unique
- 10 columns max
More details on email campaigns in Using Email FAQ
Click IMPORT/EXPORT -> Manually Add Emails to open a new modal where you can add an individual user's email and tag data.
In addition to adding a user's email, you may also add Data Tags to the user record. The Manually Add Users modal supports adding up to 10 tags.
If the email address you enter is not found in your OneSignal user list, a new user will be created. However, if the email address is found, the user will be updated with any tags that you add here. If a user already has a tag with a particular key (e.g.
levels_completed), any value you add here will replace the value the user record previously had.
.csv file that has either a
player_id and/or an
external_user_id column (one or both is required). Other columns will be the Data Tags where the top column is the "tag key" and each row under is the "tag value".
Make sure you do not have quotes around the
external_user_id and actual user ids in the csv file.
You will get a preview of the import. If the player_id or external_user_id column was not detect or entered incorrectly, it will tell you.
If you decide not to add specific tags, you can check them on or off.
You can automatically create a new segment for the imported list. This adds a tag to the newly imported list and auto-creates a segment based on the value you put.
You can delete tag values if a column is empty. See Removing Tags From A List for more.
Once you Confirm and Import you will get an email stating your CSV Import has finished.
You can use our Exporting Data guide to get a list of player ids.
In the CSV, make sure to have one column of
external_user_id the other columns will be the tag keys to delete. For example if the tags to delete keys are
key_2, etc, then each key needs to be in the first row:
To delete the tags, select Delete identifier and tag values if columns are empty
Press Confirm and Import, we will email you when finished!