---
title: "system.roster.removeUsers"
description: "Removes one or more users from an existing roster."
---

# system.roster.removeUsers

> Removes one or more users from an existing roster.

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

## Description
## Syntax
`system.roster.removeUsers(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/ignition83/latest/com/inductiveautomation/ignition/common/user/User.html) objects that will be removed from the roster. User objects can be created with the [system.user.getUser](../system-user/system-user-getUser.md) and [system.user.addUser](../system-user/system-user-addUser.md) functions.

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

## Code Examples

```python title="Code Snippet"
userSource = "default"
rosterName = "rosterEast"
     
# getUser() returns a user object, which is needed for removeUser()
user = system.user.getUser(userSource, "joe")
     
system.roster.removeUsers(rosterName, [user])
```