Skip to main content

Dimension Property Catalog

The dimension property catalog helps you track and document the properties from all configured dimension tables.

Dimension properties are added and removed automatically when you add or remove a dimension table. You cannot create or remove them manually.

image

Use cases​

Maintaining the display name and description fields of the user property records can help you:

  • map technical abbreviations and raw property names to human-readable labels
  • explain the meaning of a user property with a description

All features​

Listing dimension properties in the catalog​

The Dimension Properties tab on the catalog page lists the dimension properties stored in the catalog of the selected workspace.

The table contains the following columns:

  • Property name: This is the column name of the dimension property field in <source table name>.<column name> format. The column names of nested data structures (e.g., struct, JSON) use the <source table name>.<column name>.<field key> format.
  • Property type: This column shows whether the property belongs to Users or Groups. You can change the property type for all properties from the same table on the dimension tables page.
  • Display name: The dimension property will be referenced with this value on the Insights page, in charts, dashboards, and tooltips.
  • Description: The property description can help you find the right property when browsing the Insights page.
  • Last discovered: The elapsed time since the dimension property was last found while checking the dimension table for new properties.
  • Visibility: You can control which properties are visible on the Insights page. Select the value Hidden for a property and you won't see it listed in any dropdowns. Insights that already use this field won't break, but they cannot be recreated.

You can filter the table by using the free text search input. The list updates with the most recent results as you type your search expression. Click the Reset filters button next to the search bar to clear all filters.

Only 20 dimension properties are shown per page. To see the remaining properties, narrow the results with a search expression or browse the other pages in the pagination bar. The results are sorted in alphabetical order by property name.

Updating display name, description​

To change the display name or description of a dimension property catalog record, click the input field and enter the desired value. The catalog is updated once you stop typing.

Re-indexing dimension properties​

Dimension tables are indexed once you have configured them. If you have added or removed properties, you may not see the new properties or you may still see the removed ones. To re-index the dimension properties, click the Re-index all properties button to start the indexing process.