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.

Organize controls in a section
Docs for
Overview
Getting started
What is Bitfocus Buttons?
Install Buttons and get started
Manage your Buttons license
Activate Buttons offline
Find your way around Buttons
Create your first backup
Add an ATEM connection
Choose a control method
Choose an installation path
Install Buttons on Debian or Ubuntu
Understand HA clustering
Kubernetes HA
Update or remove Buttons
Positions
Understand positions
Create a position
Add controls and sections to a position
Create your first button
Use a connection's presets
Build more capable button actions
Add more feedback to a button
Organize controls in a section
Shift Section
Organize controls with a Folder Section
Add a Popover Section
Build and reuse a Shared Section
Build a Router Section
Understand Custom Routers
Custom Router panel
Surfaces
Surface compatibility
Add and attach a surface
Device orientation
Connections
Update a connection's module safely
Monitor and troubleshoot a connection
Router integrations
VideoHub and AJA KUMO
Utah Scientific BPS
Generic SW-P-08
Nevion VideoIPath
Arkona BLADE//runner
Routing
Physical routing
Configure ports and labels
Take a physical route
Understand route status
Topology graph
Routing Presets
Get started with virtual routing
Configure Nested Shapes
Reverse routing
Tielines
Routing Projects
Routing settings
Troubleshoot a route
Tally
Understand the Tally system
Send ATEM tally and labels to a UMD
Interpret Active Tally state
TSL/UMD connections
Diagnose tally problems
NMOS
Understand NMOS in Buttons
Connect Buttons to an NMOS Registry
Built-in Registry Server
Configure NMOS connections
Discover and adopt
Browse the NMOS inventory
Manage NMOS multicast addresses
Diagnose NMOS problems
Understand Cuelists
Build a Cuelist
Read and advance a running Cuelist
Control a Cuelist from a Position
Workflows
Understand workflows
Build your first workflow
Reuse a group of workflow nodes safely
Troubleshoot a workflow
Recipes
Sequence a timed automation
Call an HTTP endpoint from a workflow
REST endpoint
Use variables
Understand variable scope
Understand nested variables
Update expressions for v1.8
Plan and use Tags
Access
Create and manage users
Create roles and assign permissions
Grant access to specific resources
Show different controls by role
Sessions
Set up PIN and NFC sign-in
SSO
Get started with SSO
Connect a generic OIDC provider
Connect LDAP or Active Directory
Map identity claims to roles
Secure a Buttons deployment
Integrations
External control
Connect to Bitfocus Listener
USB Relay
Install USB Relay on Windows
Install USB Relay on macOS
Install USB Relay on Linux
Install USB Relay on a Raspberry Pi
Get started with the Control API
Secure and monitor the Control API
Control API reference
API reference
Administration
Enable and manage installable features
Services and health
Configure and monitor scheduled backups
Restore a backup and verify it
Export or import Buttons configuration
Store and rotate connection secrets
Replace the HTTPS certificate
HA backup and recovery
Settings
Collect support information
Reference
Glossary
Button Inspector reference
Network ports reference
Expressions
Internal actions reference
Routing Presets panel reference
Startup configuration reference
Workflow nodes
Connection workflow nodes
Workflow workflow nodes
Internal workflow nodes
Position workflow nodes
API workflow nodes
Utility workflow nodes

Loading...

Previous
← Add more feedback to a button
Next
Shift Section →
Contact support →
You are viewing documentation for Buttons 1.8.See the docs for Buttons 1.6
Buttons/Positions/Organize controls in a section

Organize controls in a section

Use a section to group controls that work together. You can color-code the group, move it around the position, or copy and paste the complete set of controls as one unit. For example, a section might contain the transport controls for a recorder or player, or a program cut bus for a video switcher.

Tip

Sections can own variables that are available to every button inside them. This makes it easier to reuse a complete feature you have built.

Create the section#

  1. Open the position editor.
  2. Click an empty canvas cell, then drag across the area the section should occupy.
  1. Right-click the selection and choose Section, or press S.
  1. In the Inspector, use Location → Size to adjust its dimensions when needed.
  1. Add buttons or nested sections inside it.
  2. Select Apply to save the layout.
Choose one recognizable purpose for the section, such as playback, monitoring, audio, or routing. If the controls need alternate layers or navigable categories, you can use a Shift Section or Folder Section instead.

Make additional controls reachable#

When a section contains more controls than its visible area can show, select the section and set Scroll to On in the inspector. Use Scrollbar to choose where its navigation control appears.
The section then scrolls independently from the rest of the position. This can keep a large set, such as camera presets, inside one logical area without expanding the entire canvas. Controls outside the visible area remain available by scrolling. On the StreamDeck Studio, the encoders can be used to scroll the sections, instead of the scroll-buttons. Click the encoder to move the cursor to different scrollable sections.

Protect critical controls when needed#

Section authentication protects controls inside a section. It is separate from signing into the Buttons Editor: a person can already be using the position and still need to unlock one protected section.
Select the section, open Authentication, then choose the mode that matches the requirement:
  • None: anyone using the position can access the section.
  • User role: require one of the selected roles. This requires a Pro license.
  • User role + PIN: require both an allowed role and the user's personal PIN. This requires a Pro license.
  • Section PIN/NFC: use codes or NFC cards configured specifically for this section.
Authentication adds an unlock step during operation. Each section can use the mode that fits its intended workflow.

Add a section code#

  1. Set Authentication Mode to Section PIN/NFC.
  2. Under Credentials, select Add Code Rule.
  3. Give the code a recognizable label and enter the required values.
  1. Add more code rules only when different people or procedures need separate credentials.
  2. Select Apply.
Use Code Input Layout to fit the keypad to the surfaces assigned to the position. Keep section codes private; do not place them in screenshots, tickets, or public documentation.

Add an NFC card#

A Stream Deck Studio can identify an NFC card for a protected section.
  1. Set Authentication Mode to Section PIN/NFC.
  2. Under Credentials, select Add NFC Rule.
  3. Present the card or tag to the Stream Deck Studio reader when prompted.
  1. Give it a label that identifies its intended use without exposing private information.
  2. Select Apply.
Repeated wrong codes are throttled per account: the first 3 wrong codes cost nothing, then each further wrong code makes the next check wait longer, starting at one second and doubling each time up to a maximum of 2 minutes. A correct code clears the history. Only codes that were actually checked and found wrong count, so a retry during an outage doesn't add to the wait. This protects against guessing without ever locking the account's owner out for longer than 2 minutes: it is not a lockout an administrator needs to reset.

Where to go next#

  • Use a Shift Section for a clear secondary layer in the same area.
  • Use a Folder Section for navigable categories.
  • Use a Popover for temporary controls that should not occupy permanent space.
  • Use a Role Section when different roles should see entirely different contents in the same area.

Was this helpful?

Was this helpful?

0 of 0 users found this page helpful