---
title: "setPrimary"
canonical: "https://help.vicon.com/space/ShogunPost121/1253736466/setPrimary"
format: markdown
---
# Description

Sets a named module as the primary selection.

Use setPrimary to make any scene module the primary selection, whether or not that module is currently selected. If there is a primary selection at the time at which the command is executed, that module will remain selected, but will no longer be primary.

## Functional area

Selection

# Command syntax

## Syntax

> Macro (scroll-tablelayout)

|  |
| --- |
| `setPrimary "name" [-prev] [-next]` |

### Arguments

> Macro (scroll-tablelayout)

| Name | Type | Required | Comments |
| --- | --- | --- | --- |
| `name` | string | no | String name of the module to be declared as primary |

### Flags

> Macro (scroll-tablelayout)

| Name | Flag arguments | Argument type | Exclusive to | Comments |
| --- | --- | --- | --- | --- |
| `prev` | 0 | — | next | If multiple modules are selected, sets the primary module to the next module of those selected. |
| `next` | 0 | — | prev | If multiple modules are selected, sets the primary module to the previous module of those selected. |

## Return value

void 

> Macro (scroll-pagebreak)

## Examples

```plaintext
// Set "LFIN" to the primary selection. 
// Currently selected modules remain selected.
setPrimary "LFIN";
```

# Additional information

## Related commands

- [select](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737508)