How do I change an event or property name?

If you’re thinking about changing an event or property name, keep in mind that:

  • It is not possible to retroactively rename the old events and properties, so by changing the names, you will be creating two events or properties that mean the same thing.

  • Your reports will be affected because pulling up an event or property by its new name will not, by default, pull up data for the old name also.

  • If you’re using the renamed event or property in a Funnel report, you may see lower conversion rates if the time period covers dates where you were using the old name.

Use Custom Events to combine old and new Event names

The good news is that if you do decide that changing an event or property name is necessary, you can create a Custom Event* to combine the new and the old, minimizing the impact on your project.

For example, if you had an old event named "Sign Up" and a new event named "Signup", a custom event will allow you to track either event in single custom event (called "Signed Up" in the example below)

Rename a Custom Event

If you've already created a Custom Event and want to rename it, select the Custom Event in a report and then click on the Edit icon (shaped like a pencil)

Then rename your Custom Event and Save!

Never created a Custom Event before? Learn more about building Custom Events.

*Limited by plan type

Enterprise plans have unlimited Custom Event capability; however, free accounts can only create one Custom Event, and Startup plan accounts can create up to 15 Custom Events - visit the pricing page for more information or to upgrade.

Avoid renaming with good Tracking Plan

Of course, it would be best to avoid having to rename events and properties in the first place so that you don’t have to create Custom Events! If you’re just getting started, here are some tips for avoiding event and property renames in the future:

  • Create a Tracking Plan - this is a great way to take a step back and really think about what sorts of events you need to track now and in the future.

  • Plan and name your events so that they will be meaningful for not just you, but also for people from all areas of your organization.

  • Use broad yet meaningful terms to classify your events. For example, if you let users share your app via Facebook, LinkedIn, and Twitter, the event name could be Shared with a property called Network, which takes the values Facebook, LinkedIn, and Twitter instead of using three events (Facebook shared, LinkedIn shared, and Twitter shared).

How to rename events and properties

It’s not possible to change the names of events and properties only in the Mixpanel UI. In order to change names, you’ll need to do so within your code. For example, if you want to change an event from “Sign up” to “Signin,” you would look for the existing mixpanel.track(“Sign up”) call and change it to mixpanel.track(“Signin”).