---
title: "ClassifierDimensions"
---

Group results by custom classifier tags, breaking down metrics by the specified dimension values. Requires an active classifier on the workspace.


## Fields

| Field                                                                                                                                    | Type                                                                                                                                     | Required                                                                                                                                 | Description                                                                                                                              | Example                                                                                                                                  |
| ---------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `classifier_id`                                                                                                                          | *str*                                                                                                                                    | :heavy_check_mark:                                                                                                                       | UUID of the classifier whose tags to group by.                                                                                           | 550e8400-e29b-41d4-a716-446655440000                                                                                                     |
| `dimension_names`                                                                                                                        | List[*str*]                                                                                                                              | :heavy_minus_sign:                                                                                                                       | N/A                                                                                                                                      |                                                                                                                                          |
| `include_nulls`                                                                                                                          | *Optional[bool]*                                                                                                                         | :heavy_minus_sign:                                                                                                                       | When true, also include generations that have no tag from this classifier. Defaults to false, which returns only classified generations. |                                                                                                                                          |