---
title: "system.roster.addUsers"
description: "Adds a list of users to an existing roster. Users are always appended to the end of the roster."
---

# system.roster.addUsers

> Adds a list of users to an existing roster. Users are always appended to the end of the roster.

This function is used in **Python Scripting**.

## Description
## Syntax
`system.roster.addUsers(rosterName, [users])`

### Parameters
Type | Parameter | Description 
------- | ------- | ------
String| `rosterName` | The name of the roster to modify.
List| `users` | A list of [User](https://sdk.inductiveautomation.com/javadoc/ignition81/latest/com/inductiveautomation/ignition/common/user/User.html) objects that will be added to the end of the roster. User objects can be created with the [system.user.getUser](appendix/scripting-functions/system-user/system-user-getUser.md) and [system.user.addUser](appendix/scripting-functions/system-user/system-user-addUser.md) functions. These users must exist before being added to the roster.

### Returns
Nothing
### Scope
Gateway, Perspective Session

## Code Examples

```python title="Code Snippet"
# Adds a couple of users to a roster.
userSource = "default"
rosterName = "rosterEast"
     
# getUser() returns a user object, which is needed for addUser()
userA = system.user.getUser(userSource, "george")
userB = system.user.getUser(userSource, "joe")
     
system.roster.addUsers(rosterName, [userA, userB])
```