Skip to content
  • Home
  • Developers
  • API
  • Releases
  • Community
  • University
  • Status
  • Home
  • Developers
  • API
  • Releases
  • Community
  • University
  • Status
Home Administration Data Governance Categories overview
Session Replay Getting Started Administration Data Management Definitions Charts Analysis Examples Heap Plays Integrations Heap Connect Data Privacy

Read in Order

  1. Data Governance: Overview
  2. Naming conventions overview
  3. Categories overview
  4. Definition Verification
  5. Event Repair Flow
  6. Dataset Cleanup
  7. Definition History
  8. Managing Events, Segments, Properties, & Reports
  9. Ongoing Maintenance

Table of Contents

Was this article helpful?

Yes No

Thank you for your feedback!

Categories overview

In this article you'll learn:

  • How to create, report, segment, and event categories
  • How to update, organize, and remove categories

You can use categories to organize your events, segments, properties, and reports, which makes it easier for your team to find what they need in Heap.

You can only create new categories while saving or editing a report, event, or segment. Check the steps below for complete steps on how to create a category while creating or updating a report, event, or segment.

Creating Report Categories

When creating a new report, on the Save as Report pop-up, simply type the name of the new Category into the ‘Select category’ box.

The 'save as new report' pop-up with the category name 'app - reads docs' added

To learn more about creating and managing reports, see our article on Reports.

Creating Event Categories

You can create new events in the Event Visualizer or from the Events tab in your Heap dashboard.

From the Event Visualizer

When creating a new event in the Event Visualizer, you can add a new event category by simply typing the new category name in the categories field while creating the event.

An event being created in the Event Visualizer with the name 'click login' and category 'app - login'

From the Events tab

You can also create a new event category while creating an event on the events tab. Simply type the new category into the categories field while creating the event.

The category 'Chrome Users' being added to an 'EV Chrome Users' event

Once the event is saved, the new category will be available in your Heap dashboard.

For more information on and best practices for defining events, see Events.

Creating Segment Categories

To create a new segment category from the Segments page, simply type the new category into the categories field while creating the segment.

The category '2019' being added to a 'New Users 2019' event

To learn more about managing segments, see Segments.

Updating Categories / Moving Things Between Categories

To change the category of an existing report, event, or segment, navigate to the page it’s listed on, click on it to open up the details, then click on it’s current category name as listed at the top of the page. A drop-down will appear where you can select a different category.

The 'App' category being added to the 'View - Updates Page' event

Move Multiple Things Between Categories At Once

You can also move multiple reports, events, or segments into a category at once. From the Reports page, the Define > Events page, or the Define > Segments page, open the category of the report, event, or segment, click the checkbox next to the item, then click the move category icon next to “x (reports / events / segments) selected”.

Removing Categories

The only way to remove a category in Heap is to remove all of the reports, events, or segments within that category. Read the section below for steps to do this.

Removing Reports, Events, or Segments from a Category

To remove a report, event, or segment from a category, navigate to the page it’s listed on, click on it to open up the details, click on its current category name as listed at the top of the page, then update the category to ‘uncategorized’.

The 'New Users 2019' event being moved from '2019' to 'Uncategorized'

The report, event, or segment will return to being uncategorized, and will appear in the ‘Uncategorized’ category on that page.

Known Limitations

You cannot batch categorize in Heap – please reach out via the Get support page if you have a large amount of definitions that you need migrated into categories and we’ll help you out!

Was this article helpful?

Yes No

Thank you for your feedback!

Last updated October 19, 2022.

categoriesevent categoriesproperty categoriesreport categoriessegment categoriesusing categories
  • Blog
  • Partners
  • Legal
  • Security
  • Terms
  • About
  • Careers
  • Privacy
  • Contact Us

© 2023 Heap, Inc.