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.

Build a Router 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
← Build and reuse a Shared Section
Next
Understand Custom Routers →
Contact support →
You are viewing documentation for Buttons 1.8.See the docs for Buttons 1.6
Buttons/Positions/Build a Router Section

Build a Router Section

A Router Section generates a complete routing panel (sources, destinations, filters, and take controls) from a set of routing resources you pick. This is different from a Custom Router, which gives you an empty context you populate yourself, button by button, from Custom Routing Presets. Use a Router Section when you want a ready-made panel over a defined set of resources; use a Custom Router when you need a bespoke layout mixed with other controls. See Add controls and sections to a position for that comparison.

Before you begin#

  • Understand the physical routing model (sources, destinations, ports, and bundles) before scoping a panel around them.
  • Familiarity with tags and collections helps: User Filters below groups sources and destinations by them.
  • A Router Section can change real signal paths as soon as it's used, so configure it against a non-production connection while you learn this workflow.
  • The selected canvas area must be at least 6 × 2 or 5 × 4 cells: Buttons disables the Router creation option with a (Too small area) note otherwise.

Example: an ATEM sources-and-destinations panel#

Continue with the non-production ATEM connection from Add an ATEM connection. The goal is a two-pane panel listing camera inputs as sources and program/auxiliary outputs as destinations, so an operator can pick a source, pick a destination, and take the route.

Create the panel#

  1. On the position canvas, select an area at least 6 × 2 or 5 × 4 cells.
  1. Right-click the selection and choose Router under Create....
  1. In the inspector's General section, set Layout to Duo. This splits the panel into a source pane and a destination pane, side by side.
  1. Set Assignment to Sources - Destinations or Destinations - Sources, depending on which side you want sources to appear on.
  1. Select Apply when you're ready to save.

Scope which sources and destinations appear#

Under Available Sources / Destinations, add the tags, collections, bundles, or individual ports that should be selectable in this panel. For the ATEM example, add the camera input bundles as sources and the M/E program and auxiliary output bundles as destinations. This is a hard limit: anything not included here can't be selected in the panel at all, regardless of the filters an operator applies later.
Default Filters works the same way but sets what's shown when no filter is currently active, rather than limiting what can ever appear.

Let operators filter live#

User Filters → Display Mode controls how operators narrow down a long list of sources or destinations while using the panel. For a Duo layout, start with Collection buttons visible, open popovers with tags: visible buttons for each collection (for example Location or Role), which open a popover of the tags within it when pressed.
  1. Under User Filters, select Display Mode and choose Collection buttons visible, open popovers with tags.
  2. Build the source and destination collection lists that should appear as filter buttons: for example, group ATEM sources by a Location tag collection so operators can filter to cameras in one part of the studio.
Other display modes suit different panel sizes and operator familiarity:
Display mode
What operators see
Off
No filter buttons; the full available list is always shown.
One button opens a popover with collection buttons
A single FILTER button opens collections, which open tags.
One button opens a popover with all tag buttons
A single FILTER button opens every tag at once.
All tag filter buttons visible directly
Every tag shown as its own button, no popovers.
Navigate: Collections → Tags → Content (with back button)
Collections act as folders; tags act as folders inside them.
Navigate: Tags → Content (with back button)
Tags act as folders directly over the source or destination list.

Group sources and destinations with Smart Navigation#

When a source or destination list is too long to scroll comfortably, Smart Navigation groups it into folders based on segments of each item's label, the same step-into-with-a-back-button pattern as the Navigate display modes under User Filters above, so operators drill down instead of scanning a flat list.
  1. Open Smart Navigation in the inspector and turn on Enable Smart Navigation.
  2. Under Apply To, choose whether grouping applies to Sources, Destinations, or both, independently of each other.
  3. Set Label Source to whichever label your naming convention actually lives on: User Label, Setup Label, Installation Label, Port Name, or Ext Custom Label.
  4. Adjust Min Items for Folder (1–10, default 2): a segment with fewer matching items than this shows those items directly at that level instead of behind a folder.
Smart Navigation splits the chosen label on whitespace into segments and builds one folder level per segment: a source labeled OSLO EVS 1 becomes the path OSLO → EVS → 1. An item without a segment left at the current level shows up there directly, even while others sharing that same path still get grouped further by their next segment. A folder containing only a single item is always shown as that item directly rather than as a one-item folder, regardless of Min Items for Folder, and if that flattening leaves exactly one folder with nothing else at that level, Buttons steps into it automatically instead of making the operator select it first.
Each folder button shows the segment name and how many items it contains. A back button appears once you've actually navigated into a folder, to return to the level above.

Choose how a route is taken#

By default, selecting a source and a destination stages the mapping without changing anything: the panel shows a Take action, the same staged-then-confirmed pattern used in Execute View. Enable Auto Take in the inspector's Options if you want selecting a pair to route immediately instead, with no separate confirmation step.
Show Release Button adds a control for releasing an already-routed destination without selecting a new source first. Releasing routes the destination to the connection's black/no-source input rather than leaving it unrouted or restoring a prior source. Confirm this is the outcome you want before using it on a production destination. Clear Selection After Take resets the panel's current selection once a route is taken, so the next selection starts fresh.

Manage locking#

A Router Section reads and writes the same lock state as Execute View, see Understand route status for what a lock means. Two panel-specific options control how locking behaves here:
  • Lock/Unlock Buttons: show them In Action Section, move them In Options Menu, or set to Hidden if this panel shouldn't expose lock controls at all.
  • Ignore Lock: lets this panel take routes even against a locked destination. Enable it only where bypassing a lock is a deliberate, understood choice.

Confirm the panel works#

Select a source and a destination in the panel, then select Take. Confirm the connected unit's active source changed and that the panel's own display (which source is shown routed to which destination) updated to match.

If you get stuck#

What you see
What to try
Router is disabled with (Too small area)
Select a larger canvas area (at least 6 × 2 or 5 × 4 cells) before creating the element.
No sources or destinations appear in the panel
Check Available Sources / Destinations: a resource not added there can't appear, even if it exists in Buttons.
A filter button doesn't show the tags you expect
Check the ordered collection list under User Filters for that side (source or destination).

Where to go next#

  • Take a route in Execute View to compare the staged-mapping flow.
  • Build a Custom Router instead, for a hand-placed layout mixed with other controls.

Was this helpful?

Was this helpful?

0 of 0 users found this page helpful