# CannedRole

object type

One canned role template: usable via copyCannedRole → an ordinary editable group Role. Hard boundaries are explicit disallow rows; amounts NEVER appear.

## Fields

| Field | Type | Notes |
| --- | --- | --- |
| `key` | [RoleTemplateKey](/types/RoleTemplateKey/) `RoleTemplateKey!` | No further notes. |
| `caption` | [String](/types/#scalars) `String!` | No further notes. |
| `version` | [Int](/types/#scalars) `Int!` | The template version. |
| `authorityTier` | [RoleTemplateKey](/types/RoleTemplateKey/) `RoleTemplateKey!` | The authority tier a copy confers. |
| `descriptors` | [RoleDescriptor](/types/RoleDescriptor/) `[RoleDescriptor!]!` | The compiled descriptor list (the CAN/CANNOT matrix over the CURRENT universe; wildcard-encoded where the matrix has no soft-cannots, allow-listed otherwise). |

## Used by

- [cannedRoles](/reference/reading-your-records/cannedRoles/)