Delete Users

How to bulk delete users

This guide explains how to delete user records from OneSignal. If you want to delete segments without the user records see Deleting Segments.

📘

Automatic User Deletion

OneSignal may delete users in apps that are deemed as being “inactive,” in-line with our Data Access and Retention Policy located in the OneSignal Privacy Policy

🚧

Deleting users cannot be reversed!

Once you delete users, there is no way to get them back. Deleted users can only get push again once they:

  • Web: Clear browser cookies, then return to your site
  • Mobile: Open the app again. We recommend being up to date on the latest version of OneSignal's SDK in the app.

Deleted users can only get email and sms again once you add their email address or phone number back into OneSignal.

❗️

WARNING: DO NOT DELETE ALL USERS

Be very careful when following these steps, make sure you do not delete all users.

Delete Users with the OneSignal API

To delete users with our API, see the Delete Users API Reference.

You can use the external_id, onesignal_id or any other alias you have set.

Delete Users with the OneSignal Dashboard

Navigate to Audience > Users.

Search for the External User ID you want to delete.

Next to each Subscription record, select the Options > Delete.

Bulk Delete Users within the OneSignal Dashboard

This guide details on how to delete multiple users and/or delete multiple subscriptions for a user within the OneSignal dashboard.

Create a Segment

See Segments for details on creating segments.

If you have a list of users, upload a CSV to add tags for segmentation.

If you want to delete older, inactive subscriptions, we recommend using the "Last Session" filter with greater than 4321 hours (6 months). Make sure to select greater than and NOT "less than".

Before deletion, we also recommend sending 2 notifications to this segment to try winning those users back.

View the Segment

When ready, select Options > View Users

1026

In Audience > Users:

  1. Check that the correct Segment is selected.
  2. Select the arrow next to 'Update/Import Users' to reveal the dropdown
  3. Select Delete Users In Segment
1523

A confirmation screen will appear showing how many users will be deleted and require you to input the name of the segment to confirm deletion.

❗️

WARNING: POINT OF NO RETURN!

Once you press Delete Users your users will be deleted.

This cannot be undone.

After clicking Delete Users a confirmation screen will appear and you will be sent an email confirming the deletion.

You cannot delete more than 1 segment at a time per app.