How do I delete People Profiles from my project?

Some Mixpanel users find that they want to delete People Profiles if they’ve accidentally imported a batch of profiles incorrectly, they have an identity management issue that leads to profile duplication, or they have gone over their profile quota and want to delete inactive profiles. Mixpanel offers several options for deleting People Profiles from your project depending on how many you want to delete and your level of technical expertise.


Important note: Whichever route you chose for deleting People Profiles, please keep in mind that deletion is PERMANENT and cannot be reverted, so delete with caution!


Delete a single People Profile

You can delete individual People Profiles via Explore by clicking into the profile in question, then clicking the delete icon:

alt text

It’s not possible to bulk delete via the Mixpanel UI. We have intentionally not included this feature to prevent accidental bulk deletion.

Bulk delete via Mixpanel-api Module

Mixpanel provides an api module to make it easy to delete your profiles. Get access to the API module here! For a quick jump directly to the People Delete section - you can head here.

Bulk delete via your own API script

Deleting profiles in bulk can be done as a People update via the API.

  1. Make a call to the /engage endpoint for a specific $distinct_id value, then

  2. Use the $delete update operation to eliminate a profile.

Learn more about the $delete update operation.

For example, if you want to delete the People Profile with distinct_id 12345, you would send the following payload:

{
"$token": "yourMixpanelProjectToken",
"$distinct_id": "12345",
"$delete": ""
}

Bulk delete via Python script

If you need to delete in bulk but are not able to bulk delete via the API, the Mixpanel support team can help by either performing the bulk deletion for you or providing a Python script that will perform bulk deletion. To prevent inadvertent People Profile deletions, the support team doesn’t provide that Python script for download by the general public, but the team is happy to help with this request.

To exercise this option:

  1. Go to Explore in your project.

  2. Filter for the profiles you’d like deleted.

  3. Provide the URL after applying the filter to the support team by emailing support@mixpanel.com.