Override and revert a property definition

Each property in the properties table represents the original version, which can be shared across multiple events and property groups. Amplitude Data applies changes to a property's details to every event and property group that shares those original details. Overriding a property on one event or property group limits any changes to that event or property group alone.

Override a property when you want to customize it for a specific event or property group without updating the original version or creating an entirely new event property. Revert the override when you want the property to track the original version again.

Override a property

To override a property on a specific event:

  1. Navigate to the Events table and click an event's name.
  2. In the event details panel that opens, navigate to Details > Properties. Then click the property you want to override.
  3. In the event property details panel that opens, click Override. A message confirms that any changes to the property apply only to that event.

To override a property on a property group:

  1. From within Properties, open the Event Properties tab to view the event properties table.
  2. Click Property Groups to switch to the property groups table view. Then click a property group name.
  3. In the property details panel that opens, navigate to Details > Properties, and click the property you want to override.
  4. In the event property details panel that opens, click Override.

Any changes to a property that's overridden on a property group apply to all events that use that property group.

Revert an override

Reverting an overridden property to its original version is a quick way to retroactively clean up your tracking plan and maintain consistency across your event properties. Reverting tells Amplitude Data to update the property to match the latest state of the original version listed in the event properties table. After reverting, any changes to the property also apply to the events or property groups that use the original version.

To revert an overridden property on a specific event:

  1. Navigate to the Events table and click an event's name.
  2. In the event details fly-out, navigate to Details > Properties and click the event property you want to revert.
  3. In the event property details panel that opens, click Manage Override.
  4. From the dropdown menu that opens, select Revert To Original.

Event rows that include "via property group…" appear in the list because those events use a property group that includes this event property. Reverting the property on any one of those events reverts the property on all of them.

To revert an event property on a property group:

  1. From within Properties, open the Event Properties tab to open the event properties table.
  2. Click Property Groups to switch to the property groups table. Then click a property group name.
  3. In the property group details panel, navigate to Details > Properties and click the property you want to revert.
  4. In the event property details panel, click Manage Override.
  5. From the dropdown menu that opens, select Revert To Original.

To see how the details change after a revert before starting the process, click Compare To Original. The original values appear under any overridden values. Turn off this view by clicking Manage Override > Hide Comparison.

Review and revert every override on a property

  1. From within Properties, open the Event Properties tab to open the event properties table, then click a property name.
  2. In the event property details panel, open the Used By tab. Any events or property groups labeled as overridden use an overridden version of that event property.
  3. Hover over the overridden event or property group row you want, and click the three-dot icon on the right.
  4. From the dropdown, select Revert To Original.

To bulk revert all overrides from the Used By tab, click Manage. A modal opens that lets you review and bulk revert your overrides.

Was this helpful?

For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.

On this page