# Position

> Position

### Create a Position

**Position** defines a collection of one or more **Surfaces**. It typically aligns with the working role of an individual, such as Vision Mixer, Graphics, or Shader. Each **Position** can be tagged for better organization. To create a new **Position**, click the *+Create* button at the top of the left pane.
A dialog box will appear, prompting you to enter a label for the **Position**. It's a good idea to plan your naming conventions beforehand to maintain a logical and consistent system. You can also create **Positions** when configuring your **Surfaces**.

*Click* *Create Position*, and the **Position Editor** window will open.

The **Position Editor** window consists of three panes:

- **Left Pane:** Navigation tree
- **Middle Pane:** A 16x16 grid called the **Canvas.**
- **Right Pane:** Contains **Inspector**, **Presets** and **Configuration** tabs.


To gain more space for editing in the position view, you can minimize the left pane.



### Configuration view


Here, you can change the name, add a description for the **Position**, and assign **Surfaces** to it.


*Click* *Assign Surface* and select the desired **Surface.**


The selected **Surface** will appear in the **Canvas** in the *Configuration* tab. A corresponding outline will also display in the center pane **Canvas**, showing the part of the **Canvas** covered by the **Surface**. You can move the **Surface** to your preferred position on the **Canvas** by dragging it in the *configuration window*. let's add another **Surface.**



Now, there are two **Surfaces** assigned to the **Position.** The outlines correspond to the button layouts of the assigned **Surfaces:**

- The **STREAM DECK STUDIO** has two rows of 16 buttons.
- The **STREAM DECK XL** has four rows of 8 buttons.

You can combine **Surfaces** freely within the same **Canvas.** You can move surfaces around from the **Configuration** window, by clicking on a surface and dragging it to a new position. Overlapping parts of **Surfaces** will display shared buttons on both.


### Position Variable

The definition of the variables are shared between all positions, while each position has its own current and initial value, independently of each other.

The values can also be used by any shared section used in a position, and will get the value from the position they are mounted on.



### Create a Button


*Click* inside any rectangle on the **Canvas;** its outline will become dashed, indicating it's selected. *Right-click* to open the context menu. From here, you can create a **Button,** **Section,** **Shift Section**, **Folder Section, Popover,** **Router** or **Shared Section.** The **Paste** and **Clear Selection** options are self-explanatory, but the other features will be explained further.



*Click* on **Button.** or you could simply press **B** instead of right clicking and selecting from the context menu.
You have now created a **Button.**

### Moving the inspector

To optimize your workspace, you can move the **Inspector pane** from the side pane to the bottom of the screen. This setting provides more real estate for making multiple edits without excessive navigation.
