# Data Catalog Events


This guide walks you through creating and managing your events in the Data Catalog.

## Required permissions

- [Admins]({{< ref "access-management/member-management.md#member-roles" >}}) have full access to manage event properties in the Data Catalog.
- [Members]({{< ref "access-management/member-management.md#member-roles" >}}) must have the following [permission]({{< ref "access-management/policies-overview.md#resource-permissions" >}}) in their workspace policy:

| Resource | Permission | <div style="width:400px">Description</div> |
| :----| :-----| :----|
| Data Catalog | **Edit** | Make changes to the configuration of Data Catalog |

{{< details "**Click here to see how these permissions appear in the workspace policy**." >}}
<br />

{{< figure src="images/access-management/data-catalog-permissions.webp" alt="Data Catalog permissions to manage properties" >}}

{{< /details >}}
<br />

#### Permissions for legacy RBAC system

In the [legacy Permissions Management (RBAC) system]({{< ref "archive/dashboard-guides/user-management.md" >}}):

- [Org Admins]({{< ref "archive/dashboard-guides/user-management.md#organization-roles" >}}) have full access to manage the Data Catalog
- Members must have the **Connections Admin** role in their workspace policy to manage events in the Data Catalog

{{< image src="images/access-management/tracking-plan-permissions-legacy-framework.webp" alt="Data Catalog permissions in the legacy framework" >}}

## Add event

RudderStack provides two ways of creating and adding events to your Data Catalog:

- [In the Data Catalog itself](#in-data-catalog)
- [While editing your tracking plan](#while-editing-a-tracking-plan)

### In Data Catalog

1. Log in to the [RudderStack dashboard](https://app.rudderstack.com/) and go to **Govern** > **Data Catalog** in the left sidebar.
2. In the **Events** tab, click **Add event**.

{{< image src="images/data-governance/data-catalog-add-event.webp" alt="Add new event" >}}

3. Select event type from the dropdown. Note that you **cannot** update the event type later.
4. Specify the event name and description.

{{< info >}}
Note that:

- You cannot set a blank event name - it must be at least 1 character long.
- RudderStack supports all UTF-8 characters in event names.
- The event name can start with a letter, number, or special character. Some examples of valid event names:

  - `Test Event`
  - `5Test Event`
  - `@4Test Event`
{{< /info >}}

5. Optionally, specify the [event category]({{< ref "data-governance/data-catalog/categories.md#manage-event-categories" >}}) from the dropdown.
6. Click **Save**.

{{< image src="images/data-governance/new-event.webp" alt="Add new event" >}}

### While editing a tracking plan

You can also create a new event while [adding a new event schema]({{< ref "data-governance/tracking-plans/view-edit-tracking-plans.md#add-a-new-event-schema" >}}) to your tracking plan configuration. 

{{< info >}}
RudderStack automatically adds this event to your Data Catalog.
{{< /info >}}

1. Go to **Govern** > **Tracking Plans** to see all the tracking plans in your workspace.
2. Click the **Add event schema** button.

{{< image src="images/data-governance/tracking-plans/tracking-plan-schema.webp" alt="Tracking Plan schema tab" >}}

3. Click **Create a new event**.

{{< image src="images/data-governance/tracking-plans/build-schema.webp" alt="Tracking Plan build schema event options" >}}

4. Specify the event type, name, description, and category.
5. Click **Create event schema**.

{{< image src="images/data-governance/tracking-plans/create-new-event.webp" alt="Tracking Plan create a new event" >}}

## Event details

Click an event in the Data Catalog to see the following information:

- Event details.
- Connections to tracking plans, along with the connected sources and associated properties (only visible after you use the event to create a tracking plan).
- Option to delete the event. Note that you **cannot** delete any event that is already connected to any tracking plan.

You can also make any changes to the event and click **Save** for the changes to take effect:

{{< image src="images/data-governance/view-event.webp" alt="View event details in Data Catalog" >}}