What are Dimensions?

The dimension of the report is what the report will be organized by. Dimensions (normally) contain qualitative values such as people, groups, time periods, activities or verbs. The dimension is used to categorize the data returned by measures. For example, if the person dimension is selected, the first column of your report will be the persons' name, and then all data returned in that row from the measures will be from data associated with that person.

Standard Dimensions

Using dimensions, data can be organized by person, group, activity, activity types, day, week, month, years, verbs, statement ID's, a statement property or by the all property.



When a report is sorted by person, each row in the report will represent an individual Person (or unassigned Persona) in Watershed.


Group dimensions return data aggregated across entire Watershed groups. There are certain measures that only work when the report dimension is group.

Activity and activity type

Activity dimensions mean the report will be organized by individual xAPI object.id's, and the activity type will organize it by the object.definition.type.

Time Periods

The day, week, month and year dimensions organize the data by the selected time period. These work on all reports, but are particularly useful on Line reports.

You can use Advanced Configuration to build reports with smaller time periods, or statement properties other than timestamp.


The Verb dimension will create a dimension for each individual verb.id returned by the reports filter.

Statement ID

The statement ID dimension is best used when you want your report to display data about every statement its filter has returned, as it creates a dimension for each individual xAPI statements id property. This means that all measures will only return a single data point, so it's best to use it with measures using the ANY aggregation, as of course ones like SUM or AVERAGE wont really work.

Statement Property

The Statement Property dimension allows you to organize the report by any part of an xAPI statement, by referring to it using dot notation. For example, if you wanted to sort by the context groupings of a statement, you would use context.contextActivities.grouping.id.

Some statement properties like arrays require some more advanced configuration.

By All

The By all dimension does not split the data at all and shows measure values for one item representing all the data. This is the dimension is normally used for Metric reports.

Advanced Dimensions

Dual Dimensions

By default all Watershed reports only use a single dimensions, but certain reports can be configured to use two. 

Person + Activity

When a Leaderboard is configured to have dual dimensions of person and activity the report will include all row for each combination of person and activity that the report filter returns. 


By default a person + activity dimension will be displayed as separate columns when viewing or downloading the report, but it can also be configured to be combined into one.


Time + Other

The line reports primary dimension is always a time period, but it can be configured with a wide range of secondary dimensions.


When a second dimension is chosen a list of the selected second dimensions then appears under the report, and when selected they are added to the report as a new line. You can also configure default secondary dimensions in the reports advanced configuration.


Please note: The dimensions property contains an array of dimension objects. For reports that do not support them additional dimensions after the first will be ignored.

Custom Dimensions

If the dimension you need is not available in the default list, you can use advanced configuration to create a custom dimension


Was this article helpful?
0 out of 0 found this helpful

If you can't find what you need or you want to ask a real person a question, please contact customer support.