This article will help you:
Events and properties are the lifeblood of any Amplitude project. Amplitude’s Govern feature makes it easy for you to manage and modify your events and event properties from one centralized location.
You can find a list of all the event types you've instrumented for a given project, along with some basic information on each, in the Events tab:
- The event type's status
- The category you've assigned it to
- Whether it is an active or an inactive event
- Whether it is visible or hidden
- Its 30-day volume, which is the number of events Amplitude has received in the last 30 days for this event type
- 30-day queries, which is the number of times this event type has been used on charts in the last 30 days (custom events are excluded from this metric)
- The date this event type was most recently seen by Amplitude
Similarly, the Event Properties tab provides you with basic information on the event properties you've instrumented for a given project:
- The property's block status, which flags any properties that are currently blocked
- The property's current 30 day queries value
- The date Amplitude first saw the property
- The date Amplitude most recently saw the property
You can view the details for an event or property by clicking its name. The details panel for an event will show you the date the event type was first seen by Amplitude, the platforms that the event type has been sent from, a list of properties associated with this event, and a list of charts that include the event. The details panel for a property will give you a list of charts that include the property.
If an event has properties associated with it, you can also view those from the Events tab itself. Click the carat next to the event's name to expand its property list below.
You can find a specific event or property using the search bar, or by using the drop-downs next to it, to filter by status or by category.
Create a custom event from existing events
You can create a custom event in the Events panel from one or more pre-existing events. Doing so tells Amplitude to combine for those pre-existing events and count any user activity for them as activity for the new custom event. This is useful if you want an easy way to track overall activity on related or similar events, like whether a visitor has fired either the view_landing_page_1 or view_landing_page_2 events.
To do this, follow these steps:
- Click the checkboxes next to the names of every event you'd like to include in your custom event.
- Click Create Custom Event.
- Give your custom event a name and description.
- Add properties to your events, if desired, by clicking where +.
- Click Save Changes.
Change an event’s category
You can update an event type's category directly from the Events tab. To do so, follow these steps:
- Click the checkbox next to the event name.
- From the Categorize drop-down, select the category to which this event should belong.
Change activity status for an event
You can change a single event's activity status simply by clicking the Activity drop-down for the event and selecting its new status.
Setting an event's activity status to inactive will remove that event from any dashboard metrics counting active users and active events. Users who only fire inactive events will not be counted as active users for that day, though they will count towards our new user definitions.
NOTE: When you change an event's activity status from active to inactive, Amplitude will apply that change immediately and retroactively, so you should expect to see changes in your historical data. Inactive events will still count against your event volume.
To change the activity status for multiple events at once, follow these steps:
- Click the checkboxes next to the desired event names.
- Click the Edit Activity drop-down, as appropriate.
- Select the event's new status.
Change visibility status for an event or property
Setting an event’s or property's visibility status to hidden is helpful for properties you may want to track but do not want to appear on the dashboard in any charts (one common example is push notification events). Marking an event or property as hidden does not delete the raw data associated with it.
You can change a single event’s or property's visibility status simply by clicking the Visibility drop-down for the event or property and selecting its new status.
To change the visibility status for multiple properties at once, follow these steps:
- Click the checkboxes next to the desired property names.
- Click the Edit Visibility drop-down.
- Select the event's new status.
Hide a property value
Setting an event property value's visibility status to hidden is helpful for values you may want to track but do not want to appear on the dashboard in any charts. Marking a property value as hidden does not delete its raw data.
To hide a property value, follow these steps:
- Find the event property with the property value you want to hide and click the checkbox next to its name.
- From the Transform drop-down, select Hide Value.
- Select the value or values you wish to hide from Amplitude and click Next.
- A confirmation modal will appear. If you still wish to hide these values from Amplitude, click Hide.
Rename a property value
To rename an event property value, follow these steps from the Event Properties tab in Govern:
- Find the event property with the property value you want to rename and click the checkbox next to its name.
- From the Transform drop-down, select Rename Value.
- The Rename Value modal will appear. Under Current Property Value, click Select Value(s)... .
- From the list, select the value you wish to rename and click Apply.
- Under Derived Value, click Select Value... to set a new value.
- Click New Value and enter the new value in the field that appears.
- Repeat steps 3 - 6 for every value you wish to rename. Then click Next.
- A confirmation modal will appear. If you still want to rename these values, click Rename.
Block and unblock events and event properties
You can prevent Amplitude from collecting data on a specific event or event property by blocking it. Amplitude will immediately stop processing data for that event or property until you decide to unblock it.
To block an event, follow these steps:
- Find the event or property you want to block and click the checkbox next to its name.
- Click Block.
- A confirmation modal will appear. If you are sure you still want to block the event or property, click Block.
- To unblock a blocked event, follow steps 1-3 and click Unblock instead of Block.
Manage the block list
The block list is a list of all the event types and user properties you are currently blocking for a specific project, as well as a historical view of previously blocked event types and user properties. The block list will also show you event types that have been deleted from your project.
You can reach the block list from Govern's Advanced tab.
You can also block event types and properties from within the block list itself. To do so, click + Add a Data Filter, and in the modal that follows, set up your parameters for the events or properties you want Amplitude to block.
Filter events from queries
NOTE: This feature is currently in closed beta release. If you'd like access, contact Amplitude support.
To create a drop filter, follow these steps:
- In Govern, navigate to the Advanced tab and click Drop Filters.
- If this is your first drop filter, you will see the following screen:
Click Create Drop Filter. If this is not your first drop filter, you will instead see a list of all the existing drop filters. Click Add Filter to add a new one.
- In the Add Drop Filter modal, click Select event … to choose the event you’d like to filter.
- Click Select property … to include any relevant properties that will refine your filter. For example, perhaps you want to filter out all purchase events that come from a specific geographical location. Simply select that location from the list of properties.
- Set the date / time ranges for the events you’d like to filter. You will need to select ranges for both event time and server upload time.
NOTE: Event time and server upload time may differ slightly in rare instances.
- If you like, add a note to explain why you’ve chosen to drop the filtered data.
- Click Add Filter to complete the process.
If you want to edit or delete a drop filter, click on its name in the drop filter list. In the panel that appears on the right, click Edit.
NOTE: Drop filters do not affect the user activity view.
Delete and undelete events and event properties
To delete events and event properties you no longer need, follow these steps:
- Find the events or event properties you want to delete and click the checkboxes next to their names.
- Click Delete.
- A verification modal will appear, instructing you to type in a confirmation phrase to continue with the deletion process. Type it in the text box and click Delete (#) Event/ Delete (#) Properties.
NOTE: Keep in mind that when you delete an event or event property, it will still appear in your historical data. Deleting an event simply means that Amplitude will no longer collect data for that event, and that the event will no longer count toward your event volume. You should also update your instrumentation to stop sending the deleted event type.
If you change your mind after you've deleted an event, you can easily undelete it. To do so, follow these steps:
- From the status filter drop-down, select Deleted. This will limit the Events/Event Properties tab to displaying only your deleted events/event properties.
- Find the events or event properties you want to undelete and click the checkboxes next to their names.
- Click Undelete.