Create a Category

Categories are used to group tiles at the Homepage. By default, all new elements are assigned to the Uncategorized Category.  


  • A Sales organization might use:  Sales, Orders, Leads, Customers.
  • A Hotel Chain might use:  Guests, Properties, Conventions, Corporate Clients.

This article is based on the assumption that you are creating your first Category. Categories will be most helpful if their title represents a meaningful grouping of information that all users can understand.

WORKFLOW: Create a Category > Configure User Permissions > Add Elements

1. Create a Category

Access Content > Categories

Access Content > Categories
  1. The list of Categories previously created in the system opens.
  2. Scroll down to the bottom of the page and click [+ New Category].

1.1. Provide basic Category information

Provide basic Category information
  1. Category name: should be descriptive and meaningful to your organization. A Sales organization might use:  Sales, Orders, Leads, Customers, etc.
  2. If the Category being created is a subcategory, select the Parent Category from the drop-down list. If it is an independent Category, leave this field empty.
  3. Business Owner: may be any User.
  4. Technical Owner / Sort Order set by: must be either Admin or Power User.

Save to access the full Category Editor.

1.2. Non-unique category names at different levels of hierarchy (nested Categories)
Non-unique category names at different levels of hierarchy

Categories with non-unique names can be created in one of the following ways:

  1. Identical subcategories can be created for different categories. In the example above, both 'Financial' and 'Revenue' categories have identical subcategories ('Monetization' and 'Customer Activity')
  2. An unlimited number of subcategories with non-unique names can be created at different levels of hierarchy.

NOTE: Categories/subcategories are shown at the Homepage once at least one element is added there.

1.3. Optional fields for Category Info tab
Category Editor - Google Chrome
  1. [6.1.0] As of Release 6.1.0, it is possible to flag elements and then Migrate Content using our Export/Import Migration Scripts. Click for details:  Scripted Migration via Category and Element Editors
  2. [5.6.1] To see how to use Custom Access Denied messages, see Set Discoverability & Custom Access Request


2. Configure Category Permissions
Once the Category is saved, configure Category Permissions

At the top right corner of the screen click Permissions. The Category Permissions pop-up opens.

2.1. Add Group/User access permission for this Category

Add Group/User access permission for this Category

NOTE: Once a Category is created, no Users or User Groups have access to it.

  1. User Groups can be granted access rights in this section
  2. In the User Access section specific Users can be granted access permission to this Category
  3. All Users (added via a Group or individually via User Access function) with permission to access Category are shown in this section. This section is purely informative and cannot be edited.

2.2. Add Group/User access to the Category

Add Group/User access to the Category

The procedure for adding permission to access a Category is identical both for Users and Groups.

Complete the associated pop-up:

  1. Select a Group from the drop-down list; all members of this Group will be granted automatic view access to this Category
  2. Optionally, grant the Group conditional edit permission to Power User members for the Category. According to this permission, those users, who have respective privileges, should get edit access to the elements in this Category. For more information, see Category Security:  Release 6.2.1 and beyond

Save and repeat as necessary.

3. Add Elements to the Category
Add elements to the Category

Assign elements to this Category in the Report / Metric Editor > Info tab > Category field.

3.1. Define Element Visibility for this Category

Define Element Visibility for this Category

Once the Category is created, it contains no elements. After elements are added, you can make all elements of this category either 'visible' or 'invisible'.

  1. Return to the Category Editor > Elements tab
  2. Click Change element visibility
  3. The Change Element Visibility pop-up opens
  4. Choose whether all elements from this Category should be either 'visible' or 'not visible' at the Homepage.
  5. Click Apply Changes for new settings to come into effect.