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.

Routing settings
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
← Routing Projects
Next
Troubleshoot a route →
Contact support →
You are viewing documentation for Buttons 1.8.See the docs for Buttons 1.6
Buttons/Routing/Routing settings

Routing settings

Settings → Routing ("Routing") holds a small set of system-wide defaults for how new route requests behave: not per-route or per-connection settings, but the baseline every new Project and route request starts from.

Before you begin#

  • Access to Settings → Routing (requires project-management permission: the same permission that governs Projects themselves).
  • A Pro or Enterprise license. On a Free or Individual license, the page shows Routing settings are unavailable instead of the settings themselves: this matches the license Projects itself requires.
  • An understanding of Projects, since two of these three settings only matter if you use them.

Understand each setting#

Under Route request defaults:
  • Default expiry mode: the pre-filled Expiry Mode (Prompt for release / Auto-release on expiry) when someone creates a new Project. It's only a starting value, still changeable per-Project at creation, and changing this setting has no effect on Projects that already exist.
  • Require project for tielines: when on, a tieline (cross-router) route request must have a Project attached. See Group and release routes with Projects for what this looks like from the routing side.
  • Persist all routes: when on, every route (not just cross-router tieline routes, which are always persisted) is recorded as a route request. Off by default, since recording every single-router route can add up in a busy facility.

Know what changing a setting actually does: and doesn't do#

None of these settings retroactively touch routes that already exist:
  • Require project for tielines, turned on, doesn't invalidate or break any tieline route that's already live without a Project. It takes effect the next time someone tries to create a new project-less tieline route (rejected before execution), or reroute an existing project-less one (also rejected): not before.
  • Persist all routes, turned off, doesn't immediately delete previously-recorded single-router route requests. Existing entries are cleaned up lazily: the next time a route is taken to that same destination, the stale recorded entry is replaced.

Note

Buttons doesn't show a confirmation dialog or a "this will affect N routes" preview before saving either setting: there's no built-in safety check here. Consider the effect on live tieline routes and any automation depending on route-request records before changing either one during a production.

If you get stuck#

What you see
What to try
A tieline route is rejected with a message about needing a project.
Require project for tielines is on: assign a Project before taking or rerouting it.
An existing tieline route without a Project still seems to be working.
That's expected: the requirement only blocks new routes and reroutes, not routes already in place when you turned it on.
Single-router routes aren't showing up as route requests.
Persist all routes is off by default: turn it on if you need those recorded too.
You turned off Persist all routes but old entries are still there.
They're cleaned up the next time a route is taken to that destination, not immediately: this is expected.
A new Project's Expiry Mode isn't what you expected.
Check Default expiry mode here: it's just the starting value, and can still be changed per-Project.

Where to go next#

  • Group and release routes with Projects
  • Use the routing topology graph

Was this helpful?

Was this helpful?

0 of 0 users found this page helpful