---
title: "Vision - Roster Management"
description: "The user management panel provides a built-in way to edit rosters from a client."
---

# Vision - Roster Management

> The user management panel provides a built-in way to edit rosters from a client.

![](../imgs/roster.png)

**Component Palette Icon**:  

![](../imgs/roster1.png)

## Description
:::note
The [Alarm Notification module](ignition-modules\alarm-notification\alarm-notification.md) is required in order to use the Roster Management component.
:::

## Properties

| Name 	| Description 	| Property Type 	| Scripting 	| Category 	|
|---	|---	|---	|---	|---	|
| Border 	| The border surrounding this component. Options are No border, Etched (Lowered), Etched (Raised), Bevel (Lowered), Bevel (Raised), Bevel (Double), and Field Border.**Note**: The border is unaffected by rotation. | Border 	| .border 	| Common 	|
| Enabled 	| If disabled, a component cannot be used. 	| boolean 	| .componentEnabled 	| Common 	|
| Name 	| The name of this component. 	| String 	| .name 	| Common 	|
| Quality 	| The data quality code for any Tag bindings on this component. 	| QualityCode 	| .quality 	| Data 	|
| Styles 	| Contains the component's styles. 	| Dataset 	| .styles 	| Appearance 	|
| Table Color 	| Changes the background color of the table rows. When a row is selected, its color will revert to highlighted. 	| Color 	| .tableBackground 	| Appearance 	|
| Table Header Color 	| Changes the background color of the table headers. 	| Color 	| .tableHeaderBackground 	| Appearance 	|
| Table Header Text Color 	| Changes the text color of the table headers. 	| Color 	| .tableHeaderForeground 	| Appearance 	|
| Table Text Color 	| Changes the text color of the table rows. When a row is selected, its text will revert to black. 	| Color 	| .tableForeground 	| Appearance 	|
| User Source 	| The user source to manage users in. If blank, uses the project's default user source. 	| String 	| .addFromUserSource 	| Behavior 	|
| Visible 	| If disabled, the component will be hidden. 	| boolean 	| .visible 	| Common 	|
| Window Color 	| Changes the background color of the window. 	| Color 	| .windowBackground 	| Appearance 	|
| Window Header Color 	| Changes the background color of the window header. 	| Color 	| .windowHeaderBackground 	| Appearance 	|
| Window Header Save Button Background 	| Changes the background color of the window header save button. 	| Color 	| .windowHeaderSaveButtonBackground 	| Appearance 	|
| Window Header Save Button Text Color 	|Changes the text color of the window header save button. 	| Color 	| .windowHeaderSaveButtonForeground 	| Appearance 	|
| Window Header Text Color 	| Changes the window header text color. 	| Color 	| .windowHeaderForeground 	| Appearance 	|
| Window Text Color 	| Changes the window header text color. 	| Color 	| .windowForeground 	| Appearance 	|

## Scripting
See the [Vision - Roster Management Scripting Functions](roster-management-scripting-functions.md) page for the full list of scripting functions available for this component.

### Event Handlers
Event handlers allow you to run a script based off specific triggers. See the full list of available event handlers on the [Component Events](ignition-modules/vision/scripting-in-vision/component-events/component-events.md) page.

## Customizers
* [Vision Component Customizers](ignition-modules/vision/working-with-vision-components/vision-component-customizer/vision-component-customizer.md)