Data Catalog

Build a data catalog by creating events and properties for tracking plans.
Available Plans
  • free
  • starter
  • growth
  • enterprise

RudderStack’s Data Catalog feature lets you create the events and properties for configuring tracking plans. You can also define all the necessary details for your events and properties like name, type, description, category, etc.

Once created, you can select the required events and associate them with properties while creating a tracking plan.

success

You can also use the Data Catalog API to:

  • Create and manage your tracking plans programmatically.
  • Add or update events and properties in your data catalog.
  • Create and manage new categories for your data catalog events.

See this self-paced product tour for data catalog:

Add event

  1. Log in to the RudderStack dashboard and go to Monitor > Data Catalog option in the left sidebar.
  2. In the Events tab, click Add event.
Add new event
  1. Select event type and category from the dropdown and specify the event name and description. Note that you cannot update the event type later.
  2. Click Save.
Add new event

Event details

Once created, you can click the event to see the following:

  • 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)
  • Delete event
warning
You cannot delete an event from the data catalog if it is connected to any tracking plan.

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

View event details in data catalog

Add property

  1. Log in to the RudderStack dashboard and go to Monitor > Data Catalog option in the left sidebar.
  2. In the Properties tab, click Add property.
Add new property
  1. In the Property details tab, specify the property name and description.
  2. Choose the data type for your property from the dropdown. You can choose multiple data types as per your requirement.
Add new property
  1. Click Save to save the changes and add the new property to your data catalog.

Property details

Once created, you can click the property to see the following:

  • Property details like name, description, and data type.
  • Connections to tracking plans, along with the connected sources and associated events (only visible after you map the property to an event while creating a tracking plan).
  • Delete property from data catalog.
warning
You cannot delete a property from the data catalog if it is connected to any tracking plan.

You can make any changes to the property details in this tab. Make sure to click Save for the changes to take effect:

Add new property

Advanced rules

While adding or editing a property, go to the Advanced rules tab to add rules that define how RudderStack should capture a property.

info
You can set advanced rules for properties of all the data types except Object and Null.

You can define the following advanced rules for the property depending on its data type:

Add category

You can associate an event in the data catalog with a category it best fits into. Go to the Events tab, click Select category, and choose a category from the dropdown.

RudderStack provides the following four categories by default:

  • Conversion
  • General
  • Marketing
  • Onboarding

To associate an event with a custom category, click Select category and enter the new category name.

Data catalog categories

Questions? Contact us by email or on Slack