---
---

# shift_monitors

Swaps the workspaces of every screen in the given direction.

> [!Note]
> the behavior can be hard to predict if you have more than 2 monitors (depending on your layout).
> If you use this plugin with many monitors and have some ideas about a convenient configuration, you are welcome ;)

> [!Tip]
> On Niri, this plugin moves the active workspace to the adjacent monitor instead of swapping workspaces, as Niri workspaces are dynamic.

Example usage in `hyprland.conf`:

```sh
bind = $mainMod, O, exec, pypr shift_monitors +1
bind = $mainMod SHIFT, O, exec, pypr shift_monitors -1
```

## Commands

<PluginCommands plugin="shift_monitors"  version="3.3.1" />

## Configuration

This plugin has no configuration options.
