---
title: "system.nav.desktop"
description: "Allows for invoking system.nav functions on a specific desktop."
---

# system.nav.desktop

> Allows for invoking system.nav functions on a specific desktop.

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

## Description
Allows for invoking [system.nav](appendix\scripting-functions\system-nav\system-nav.md) functions on a specific desktop.

See the [Multi-Monitor Clients](ignition-modules\vision\common-tasks-in-vision\multi-monitor-clients\multi-monitor-clients.md) page for more details.

## 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.nav.desktop(handle)`

### Parameters
Type | Parameter | Description 
------- | ------- | ------
String | `handle` | The handle for the desktop to use. May be omitted for the primary desktop. [optional]

### Returns
**INavUtilities** -  A copy of [system.nav](appendix\scripting-functions\system-nav\system-nav.md) ([INavUtilities](https://files.inductiveautomation.com/sdk/javadoc/ignition80/8.0.12/com/inductiveautomation/factorypmi/application/script/builtin/INavUtilities.html)) that will alter the desktop named by the given handle.

### Scope
Vision Client

## Code Examples

```python title="Example #1"
# The following example will close a window at path "Main Windows/Overview" in the Primary Desktop,
# regardless of where the script originates from.
system.nav.desktop().closeWindow("Main Windows/Overview")
```

```python title="Example #2"
# Attempts to swap to a window at path "Main Windows/Main Window" on a specific Desktop. This example assumes a desktop with the handle "2nd Desktop" is already open.  
system.nav.desktop("2nd Desktop").swapTo("Main Windows/Main Window")
```