netbox-community-netbox/docs/models/dcim/devicerole.md

# Device Roles

Devices can be organized by functional roles, which are fully customizable by the user. For example, you might create roles for core switches, distribution switches, and access switches within your network.

## Fields

### Name

A unique human-friendly name.

### Slug

A unique URL-friendly identifier. (This value can be used for filtering.)

### Color

The color used when displaying the role in the NetBox UI.

### VM Role

If selected, this role may be assigned to [virtual machines](../virtualization/virtualmachine.md)

### Configuration Template

The default [configuration template](../extras/configtemplate.md) for devices assigned to this role.
Refactor device docs 2020-03-05 11:05:48 -05:00			`# Device Roles`

Update device documentation 2020-07-28 11:32:32 -04:00			`Devices can be organized by functional roles, which are fully customizable by the user. For example, you might create roles for core switches, distribution switches, and access switches within your network.`
Finish refreshing DCIM models documentation 2022-08-15 15:16:02 -04:00
			`## Fields`

			`### Name`

			`A unique human-friendly name.`

			`### Slug`

			`A unique URL-friendly identifier. (This value can be used for filtering.)`

			`### Color`

			`The color used when displaying the role in the NetBox UI.`

			`### VM Role`

			`If selected, this role may be assigned to [virtual machines](../virtualization/virtualmachine.md)`
Closes #11559: Implement config template rendering (#11769) * WIP * Add config_template field to Device * Pre-fetch referenced templates * Correct up_to_date callable * Add config_template FK to Device * Update & merge migrations * Add config_template FK to Platform * Add tagging support for ConfigTemplate * Catch exceptions when rendering device templates in UI * Refactor ConfigTemplate.render() * Add support for returning plain text content * Add ConfigTemplate model documentation * Add feature documentation for config rendering 2023-02-17 08:33:08 -05:00
			`### Configuration Template`

			`The default [configuration template](../extras/configtemplate.md) for devices assigned to this role.`