---
title: Event taxonomy
slug: analytics/docs/event-taxonomy
docTags: 
createdAt: 2026-07-20T15:44:25.720Z
---

Event taxonomy helps you organize the events in an event stream, creating an efficient and streamlined experience. With event taxonomy, you can control which events are visible in the event selector inside templates. You can also make changes to the configuration of individual events, such as modifying their names, descriptions, and definitions.

## Access events

Go to **Data > Events**. All event streams in your dataset display here.

![Click Data and Events to view event streams](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/P1tPhQGCFN9XN8abzWY06_click-data-events-to-view-event-streams.png)

## Manage event stream details

### Locate specific events

To see details related to an event stream, click the stream and view details like **display name**, **descriptions**, **definition**, and **visibility status**.

![Click an event stream to view its details](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/el9cU0HyhP8bsmEPgscZ3_click-event-stream-to-view-details.png)

To search for specific events in the events stream, enter the event name in the search bar.

![Search for specific events](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/dzybSvWmVn6kEedaBNOTG_locate-specific-events.png)

To filter events by their visibility status, use the **Visibility** drop-down list. The following options are available:

- **All Visibility** – View events regardless of their visibility status.
- **Visible** – View visible events.
- **Hidden** – View hidden events.

![Use the Visibility drop-down list to filter events by visibility status](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/MrrlV0ievOXH7cPazYpol_use-visibility-drop-down-to-filter-by-visibility-status.png)

### Modify event details

To modify an individual event, click anywhere on the event or select **More** **>** **Edit**, make changes to its information, and then click **Apply**.

![Click More and select Edit to modify an event](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/fCuuxFLdeelEhBtJmznpU_modify-event-click-more-select-edit.png)

![Click Apply to save event edits](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/lDXPQr-8b5yD2ehqSkZMm_click-apply-to-save-event-edits.png)

:::hint{type="info"}
**Note**

Event descriptions display on hover wherever you can select events in the Analytics app. Users can manually specify descriptions, including updating descriptions that automatically sync from the table description in the data warehouse when there are tables in union datasets that contain only one event type.
:::

### Event usage stats

Each event type carries usage stats collected from daily event counts. Use them to separate a live event from one that stopped receiving data. Hover an event to open its popover, which reports the following stats:

- **Average** – The average number of events received per day.
- **Present on** – The days the event was received, out of the days counted.
- **Trend** – The daily change as a percentage. Optimizely shows a trend only when the direction is clear enough to report.
- **Your usage** – How often you query the event, ranked against every event in the app.
- **App usage** – How often everyone in the app queries the event, ranked the same way.

![Event usage stats](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/gMsK6M84Xco-7638YMEon_event-usage-stats.png)

The two usage ranks measure how often an event is queried, not how much data it receives. A high-volume event that nobody analyzes ranks low.

The daily average uses the days Optimizely holds counts for, up to the most recent 30. A recently synced dataset reports a shorter window rather than counting the missing days as empty. Optimizely recounts every two days, so a newly instrumented event has no stats until the next run. The stats do not change when you change the time range of an analysis.

A daily average of zero, or no stats at all, means Optimizely holds no recent counts for the event. Check whether the event was merged into another event, and whether its dataset still receives data. Hide the event when it is obsolete. Raise it with the team that owns the dataset when the event should still arrive.

### Control visibility of events

To control the visibility of an event, toggle **Visible** on or off for each event.

![Toggle Visible for an event](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/Rsha7WuoDAJkC9plh2VVx_toggle-visible-events.png)

To hide multiple events, select the events using the checkboxes and click **Hide**. This turns the status of the selected events to **Hidden**.

![Select multiple events and click Hide](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/4hoivJLSZJ72hctNvJaAp_select-multiple-events-click-hide.png)

To display previously hidden events, select the events using the checkboxes and click **Show**. This turns the status of the selected events to **Visible**.

![Select multiple hidden events and click Show](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/3SMc6SOQy4-pdkzwhoXD__select-multiple-hidden-events-click-show.png)

To categorize events for organizational purposes, click the drop-down list in the **Categories** column and select an existing category. You can also create a category by clicking **+**. [See Manage Categories](docId\:hCBYJYC_nvnwUro4r64PX).

![opti-events-8.png](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/XZ463YjToD2ZR0PtnmANB-20260720-144949.png)

### Merge events

Merging events streamlines analysis by combining related actions, such as unifying separately captured events like explorations and dashboards, or consolidating renamed events over time.

1. Select the events using the checkboxes and click **Merge**.

   ![Select multiple events and click Merge](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/OEEaqcmnVmC3NLngBgpzD_select-multiple-events-click-merge.png)
2. Enter the **Display Name**, **Description**, and set the **visibility** status of the selected events you want to merge.

   ![Enter the display name, description, and visibility for the merged event](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/kr6WqpUOGAykKcAsAXNFM_enter-name-description-visibility-for-merged-event.png)
3. (Optional) Add events to the merge list by clicking the **Definition** field and selecting the events from the drop-down list.

   ![Click the Definition field to add more events to the merge](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/RFgK-JhRvTr_ul2YM0ZWe_click-definition-to-add-more-events.png)
4. Click **Apply** to see the merged event.

   ![Merged event in the events list](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/jVdwmDqRh7m_jXi5MVJcX_merged-event-view.png)

### Unmerge events

1. Click the merged event.
2. Remove events that you want to unmerge from the **Definition** field.
3. (Optional) Rename the event.

   ![Remove events from the Definition field and click Apply to unmerge](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/yNPFllxnOcqfJQeBZDgvh_unmerge-events-click-apply.png)
4. Click **Apply**.
5. The unmerged events display in the original event list.

   ![Unmerged events display in the events list](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/f_q05cJ757zOHUWAafo36_unmerged-events-display-in-events-list.png)

### Delete multiple events

You can delete events you no longer need from the event catalog in one action instead of one at a time. Deleting an event removes its configuration in Optimizely Analytics, such as its display name, description, and visibility settings. It does not affect the underlying event data in your data warehouse.

To delete multiple events, do the following:

1. Go to **Data** > **Events**.
2. Select the events using the checkboxes. The toolbar shows how many events you have selected.
3. Click **Delete**. The button shows the number of selected events, for example **Delete (3)**.

   ![Select multiple events and click Delete](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/LyC77SeAowUd_6mjjr77M_select-multiple-events-click-delete.png)
4. In the confirmation dialog, check the number of events you are about to delete and click **Yes**. To keep the events, click **No**.

:::hint{type="warning"}
**Warning**

You cannot undo a deletion. To use a deleted event again, you must recreate its configuration.
:::

### Refresh event details

To refresh the page, click **Refresh**.

![Click Refresh to refresh event details](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/p08zs7TuK54AklSUvUnRD_refresh-event-details.png)

## Custom events

You can create custom events directly from the **Events** section or the app Menu bar. Custom events are cohorts of events that fall under a single event stream. When you create the custom event, you can select events by name using the **Filtered Event** block.

### Create a custom event

![Analytics-Event Taxonomy-Custom Events.png](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/Rv78RHB0OeRu7JOhG468m-20260720-144949.png)

To create a custom event, do the following:

1. Go to **Data** > **Events**.
2. Click **New custom event**.
3. Enter a name for your event and add a desired description.
4. Use the **Cohort of** drop-down list to select the event stream where you want to create a custom event. This opens the cohort editor.
5. In the **Filtered Event** block, select the events you want to include in the cohort and click **Apply**.
6. **Run** the cohort and click **Save**. The system creates your custom event, and it is visible under the **Custom Events** tab in the **Events** section.

### Edit, duplicate, or delete a custom event

To edit, duplicate, or delete an existing custom event, do the following:

1. Go to **Data** > **Events**.
2. In the **Custom Events** tab, click **More** (**...**) corresponding to the event you want to edit, duplicate, or delete, and click on the associated option.
3. Make the necessary edits and click **Save**.

![Analytics-Event Taxonomy-Edit Custom Events.png](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/_6jYcjYVEvGoVs1CI2nTX-20260720-144949.png)