---
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
See the [Multi-Monitor Clients](clients\multi-monitor-clients.md) page for more details.

## Client Permission Restrictions
This scripting function has no [Client Permission](projects\project-properties\project-properties.md#client---permissions) restrictions.

## Syntax
`system.nav.desktop(handle)`

### Parameters

|Type|Parameter|Description|
|--|--|--|
|String| `handle` |The handle for the desktop to use. The screen index casted as a string may be used instead of the handle. If omitted, this will default to the Primary Desktop. Alternatively, the handle "primary" can be used to refer to the Primary Desktop.|
### Returns
**INavUtilities** -  A copy of system.nav that will atler the desktop named by the given handle.
### Scope
Client

## Code Examples

```python title="Code Snippet"
# 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="Code Snippet"
# 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")
```