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.

Plan and use Tags
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
← Update expressions for v1.8
Next
Access →
Contact support →
You are viewing documentation for Buttons 1.8.See the docs for Buttons 1.6
Buttons/Organization/Plan and use Tags

Plan and use Tags

Tags let you organize Connections, Positions, Surfaces, Workflows, Cuelists, and routing resources by whatever structure actually matches your facility (studio name, room, floor, equipment type, or anything else) without forcing everything into one fixed hierarchy. A resource can carry tags from several different Collections at once, so the same camera can be found by room, by format, and by role at the same time.

The three tag elements#

Selecting + Create on the Tags page offers exactly three kinds of element:
  • Folder: organizes Collections into logical groups. A Folder holds Collections; it doesn't hold tags directly.
  • Collection: contains multiple Tags, and is what you use to group tags together and build filters from.
  • Tag: the label you actually assign to a resource. Every Tag belongs to a Collection.
This structure means you always create a Collection before you create the Tags that live inside it, and you can group related Collections under a Folder once you have several.

Create a Collection and its Tags#

  1. Open Tags.
  2. Select + Create, then Collection.
  3. Enter a Label.
  4. Optionally set Restrict Resource Type to limit this Collection's tags to specific resource types: Connection, Position, Surface, Shared Section, Workflow, Cuelist, Salvo, Router Source Bundle, Router Destination Bundle, or (when virtual routing is enabled) Virtual Bundle. Leave it unset to allow the Collection's tags on any resource.
  5. Select Create.
  6. Select + Create again, then Tag.
  7. Enter a Label, choose the Parent Collection, and select Create.
Repeat for every Tag you need in that Collection. A resource can hold any number of Tags from any number of Collections at once: nothing about this structure implies a single correct hierarchy.

Assign tags to a resource#

Most resources that accept tags show a tag box with placeholder text Click to assign.... Selecting it opens a searchable tree of your Folders, Collections, and Tags: check the ones you want, then select Select. Only Tags whose Collection isn't restricted away from that resource's type appear as options.
When you select several resources of the same type at once, the same control shows partial-assignment state, so you can add or remove a tag across all of them in one action without disturbing tags only some of them already had.
You can also work from the Tag's own side: opening a Tag shows an Assigned Resources panel, organized by resource type (Source Bundles, Destination Bundles, Virtual Bundles, Connections, NMOS Nodes, Positions, Shared Sections, Surfaces, Workflows), where you can search for and check resources to attach that one Tag to many of them at once. If the Tag's Collection has Restrict Resource Type set, only the allowed resource type's section appears here: the same restriction that limits where the Tag can be assigned from also limits what shows up on this side.

Filter by tag#

Tag-aware lists across Buttons (for example, the source and destination lists in Routing → Execute) offer a Tags filter alongside their other filters (such as Connections or NMOS). Selecting it opens the same searchable tag tree; picking a Tag, Collection, or Folder narrows the list to matching resources.

Automatic tags#

Buttons assigns some tags for you, based on what a resource actually is:
  • Connections and routing ports can pick up tags automatically from three built-in tag families: Format (such as SDI, NMOS, SRT, NDI, MADI, Dante, Analog), Equipment (such as Camera, Vision Mixer, CCU, Player, Recorder, Monitor, Router, Converter), and Role (such as Multiviewer, Input, Aux, M/E, Generator, Intercom, Transport): whenever the connection or connection module reports matching properties. These automatic assignments update on their own as connections and modules change; you don't need to maintain them by hand.
  • A Collection's Category can mark its tags as a Default Source Filter, Default Destination Filter, or Default Generic Filter. Tags from a Collection with one of these categories are used to automatically pre-populate the default source/destination tag filters on a newly created router section.
  • Any Tag you create can opt into this same mechanism: its Auto Tag Bundles field lets you pick one or more of the built-in Format/Equipment/Role values, and your Tag then gets assigned automatically to every routing source or destination that already carries that value, and unassigned again if the port stops reporting it: the same way the built-in tags themselves behave. This lets you fold your own naming onto the automatic behavior instead of tagging every matching port by hand.
You can still tag a resource manually alongside whatever Buttons assigned automatically: the two aren't exclusive.

Delete a Folder, Collection, or Tag#

Deleting any of the three is immediate: there's no warning that a Collection's own Tags (and their assignments) are being removed along with it, and no check for whether a Tag is still assigned to resources.

If you get stuck#

What you see
What to try
A Tag doesn't appear as an option when assigning it to a resource.
Check whether the Tag's Collection has Restrict Resource Type set to something that excludes this resource.
A tag you expected to appear automatically never shows up.
Automatic tags depend on the connection or module reporting matching properties: confirm the connection is actually the type you expect, and that it's connected.
You can't decide whether something needs a Folder, a Collection, or a Tag.
You almost always want a Collection with Tags inside it; reach for a Folder only once you have several related Collections to group together.

Where to go next#

  • Configure ports and labels, for how Tags interact with routing ports specifically.

Was this helpful?

Was this helpful?

0 of 0 users found this page helpful