---
title: Edit event and property details
description: "Edit an event or property's category, activity status, description, data type, display name, visibility, and official status in Amplitude Data."
product: data
lang: en
last_updated: 2026-11-20
token_estimate: 2312
---
# Edit event and property details

Each event and property in your tracking plan carries details that control how it appears in Amplitude and how analysts interpret it. Edit these details from the _Events_ or _Properties_ tables in Amplitude Data, or from an item's details panel.

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

> **Note:**
>
> These settings apply to active events and properties included in your tracking plan. Most don't apply to custom events. Where a setting behaves differently, this page says so.

## Set an event's category

Categories group related events so your team can find them in long event lists.

1. Go to the _Events_ page and select the **Events**, **Custom Events**, or **Labeled Events** tab.
2. Click the checkbox next to the event name.
3. From the **Categorize** drop-down, select the category this event belongs to.

For events on the _Events_ tab, categorization applies only to active events included in your tracking plan.

You can also change an event's category from the _Category_ column in the _Events_, _Custom Events_, or _Labeled Events_ tables, or from its right-hand fly-out panel. From a table, use the _Category_ column's drop-down menu. From the panel, click the event name to open its _Details_ panel, go to _Category_, and select the new category.

## Set an event's activity status

An event's activity status tells Amplitude whether to count that event in metrics that track active users and active events. An active event is one the user actively engaged with, like clicking the Add to Cart button. An inactive event is one that happened to the user without any specific action on their part, such as `Push Notification Sent` or `Message Received`.

Setting an event as inactive removes it from dashboard metrics that count active users and active events. Users who only trigger inactive events don't count as active users for that day, though they do count toward Amplitude's new user definitions.

> **Note:**
>
> When you change an event's activity status from active to inactive, Amplitude applies that change immediately and retroactively, so expect to see changes in your historical data. Inactive events still count against your event volume.

1. Click the checkbox next to the event name. Select more than one event to change several at once.
2. Click the **Edit Activity** drop-down menu.
3. Select the new event status.

Activity status applies to active events and event properties included in your tracking plan. It doesn't apply to custom events.

You can also update activity status from the _Activity_ column in the _Events_ table, or from a specific event's _Details_ flyout.

## Add a description to an event or property

Descriptions help other members of your organization understand what an event or property represents.

To add a description to an event:

1. Go to _Events_ and click the name of the event you want to describe.
2. In the flyout that appears, click **Add a description** (under _Details_).
3. Type a description of the event and click **Apply**.

### Describe an event property

The same event property can apply to multiple event types, so you can describe either the original (global) property or a version overridden for a specific event or property group. When no override exists, the description defaults to the global event property.

> **Note:**
>
> Event properties that aren't overridden share the same original event property details.

To change the global description for an event property, go to _Properties > Event Properties_, click the event property name to open its _Details_ panel, type a description, and click **Apply**.

To change the description for an event property overridden on a specific event:

1. Go to the _Events_ table and click the event name.
2. In the event details panel, go to _Details > Properties_, then click the property you want to update.
3. Make sure the event property is overridden. If it is, _Manage Override_ appears in the blue box within the details panel, and you can skip to step 4. Otherwise, click **Override** to apply the change only to that event or property group.
4. Click the field directly below the property name and type a description of the property.

### Describe a user or group property

Go to _Properties > User Properties_ or _Properties > Group Properties_. Click the property name to open its _Details_ panel, type a description, and click **Apply**.

On paid plans, Amplitude can suggest descriptions automatically. Refer to [AI-generated descriptions](https://amplitude.com/docs/data/ai-generated-descriptions).

## Change a property's data type

Amplitude type-checks property values against the specified type and detects when event data doesn't match it, so update the type as your data and analysis needs change.

1. Click the property's name to open the details panel.
2. Select the property's new data type from the _Type_ drop-down.

| Type | Values it accepts |
| --- | --- |
| `String` | A string value. |
| `Number` | Numerical values, such as 12345. |
| `Boolean` | Values representing Boolean states ("true" / "false", "yes" / "no", "0" / "1"). |
| `Array` | A collection of values stored in a single property, such as `["apple", "banana", "strawberry"]` or `[1, 2, 3]`. |
| `Enum` | One of a set of possible values, for example property `fruit` is one of \[apple, banana, strawberry\]. |
| `Const` | A constant value. |
| `Any` | Any value. |

## Change a display name

By default, an event's display name matches the ingested name. These names can be difficult to read and incorporate into analyses, so you can give events and user properties readable display names.

> **Note:**
>
> A display name changes how the event or property appears in the Amplitude UI. It doesn't change the raw data.

To change an event's display name:

1. Click **Events** in Amplitude Data's left-hand rail.
2. Click the event name.
3. Type the new display name for the event.

To change a user property's display name:

1. Click **Properties** in Amplitude Data's left-hand rail and open the **User Properties** tab.
2. Click the property name to open the details panel.
3. Click the property name in the panel and enter a display name.

## Update an event's visibility

Hide events from areas of Amplitude where you don't want them. For example, hide noisy events from your user stream so the remaining data is more useful.

Support for updating visibility depends on the event type.

| Event type | Editable? | Where to edit |
| --- | --- | --- |
| Default events | Must be in the tracking plan, and have `Modify` enabled. | Table menu, table row, side panel. |
| Transformed events | Yes. Hiding from event streams isn't supported. | Side panel |
| Live events | Yes | Table menu, table row, side panel. |
| Planned events | No |  |
| Unexpected events | No |  |
| Blocked events | Yes | Table menu, table row, side panel. |
| Deleted events | No |  |

To update an event's visibility:

1. Go to _Data > Events_.
2. Select the events you want to update.
3. In the menu at the top of the table, click **Edit visibility** and select the areas where you don't want the selected events to appear.

## Mark an event or property as official

Mark the events and properties your team trusts as official to show that they're vetted, authoritative, and safe to use in analyses. Official designations help analysts and product managers build charts on reliable data, and Amplitude's AI agents favor official events and properties when they answer questions.

Marking an item official doesn't change the underlying data or how Amplitude ingests it. Instead, it adds a trust signal across Amplitude:

- Event and property selectors show an **Official** filter, so you can narrow long lists to endorsed items.
- Amplitude's AI agents weigh official events and properties more heavily when they choose data for an answer.

Use official designations for events and properties in your tracking plan. To endorse reusable analysis objects like metrics, custom events, cohorts, and segments, use [Object management](https://amplitude.com/docs/data/object-management) instead.

Changing an event or property's official status requires the _Manage tracking plans_ permission. Members without it can see which items are official but can't change the designation.

1. In Amplitude Data, go to _Events_ or _Properties_.
2. Click the event or property name to open its details panel.
3. Click the **Official** control to mark the item official. Click it again to remove the designation.

To update several items at once, select them in the _Events_ or _Properties_ table, then set their official status from the menu at the top of the table.

To find official events and properties, apply the **Official** filter in a chart's event or property selector, or filter the _Events_ or _Properties_ table by official status in Amplitude Data.

> **Note:**
>
> Marking an event or property official is a trust signal only. It doesn't block, hide, or transform data. To control which data Amplitude ingests, use blocking and [transformations](https://amplitude.com/docs/data/transformations).

