Bitfocus AS
logo
logo
Bitfocus AS
logo
logo
Sign upSign in

Loading...

Bitfocus

Subscribe to our newsletter

The latest news, articles, and resources, sent to your inbox.

FacebookInstagramGitHubYouTubeLinkedIn

Products

  • Buttons
  • Companion

Integrations

  • Supported Devices
  • Developer Community
  • Connection Development

Support

  • Support Overview
  • Documentation
  • Video Tutorials
  • Community Forum

Sales

  • Resellers & Integrators
  • Buttons Pricing

Updates

  • Case Studies
  • Events & Trade Shows
  • Press Releases
  • Product Updates
  • Webinars

Legal

  • Legal Overview
  • Privacy Policy
  • Buttons EULA
  • Terms & Cookie Policy

Company

  • About us
  • Press kit
  • Careers

© 2026 Bitfocus AS. All rights reserved.

Position
Docs for
Buttons overview
Adding a License
Offline License
Debian/Ubuntu-headless build of Bitfocus Buttons
Position
Basic Section
Shift Section
Folder Section
Popover Section
Router Section v1.4.x
Router Section v1.6.x
Shared Section
Button
Presets
Internal Actions
Connect
Connection
NMOS
Surface
Workflow
Workflow Examples
Workflow node reference
Cuelist
Tags
Routing
Auth
SSO
Settings
Certificate
Network ports reference
Variables
Functions Reference
Functions
Operators

Loading...

Previous
← Debian/Ubuntu-headless build of Bitfocus Buttons.
Next
Basic Section →
Contact support →
Buttons/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.

Was this helpful?

Was this helpful?

0 of 0 users found this page helpful