---
title: "system.vision.setScreenIndex"
description: "Moves an open client to a specific monitor."
---

# system.vision.setScreenIndex

> Moves an open client to a specific monitor.

:::info Backwards Compatibility
This function replaces [system.gui.setScreenIndex](versioned_docs/version-8.1/appendix/scripting-functions/system-gui/system-gui-setScreenIndex.md). Any scripts containing Vision Client scoped functions that were replaced with system.vision syntax will still work to maintain backwards compatibility.
:::

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

## Description
Moves an open client to a specific monitor. Use with [system.vision.getScreens()](appendix\scripting-functions\system-vision\system-vision-getScreens.md) to identify monitors before moving.

:::note
This function is available on secondary desktops via the [system.vision.desktop](system-vision-desktop.md) function. See the [Multi-Monitor Clients](ignition-modules\vision\common-tasks-in-vision\multi-monitor-clients\multi-monitor-clients.md) page for more details on secondary desktops.
:::

## Client Permission Restrictions
This scripting function has no [Client Permission](../../../ignition-modules/vision/vision-project-properties/vision-project-properties.md#vision-permissions-properties) restrictions.

## Syntax
`system.vision.setScreenIndex(index)`

### Parameters
Type | Parameter | Description 
------- | ------- | ------
Integer | `index` | The new monitor index for this client to move to. 0 based.

### Returns
Nothing

### Scope
Vision Client

## Code Example
```python title="Setting a Screen's Index"
# This example could be used on a startup script to move the client to a 2nd monitor.
  
system.vision.setScreenIndex(1)
```