# Configure ports and labels

> Read the Ports Config table, give ports User, Setup and Installation labels, set a custom sort order, hide unused ports and understand port warnings.

Buttons lets you rename what you see, not what the connection sends: give every port a clear label for the people who'll actually use it, without touching the underlying source. This page covers reading the Ports Config table, applying labels, and setting the order ports appear in. Ports Config shows every port on the system, including ports that don't appear in the routing views elsewhere. Ports or bundles that are hidden or disabled still show in this list, so this is the place to find and bring them back. Before you begin At least one connection that exposes routing ports, such as an ATEM connection. See Add an ATEM connection if you don't have one yet. Access to Routing → Ports or Routing → Labels . How the page works Ports and Labels in the left navigation open the same Ports Config table in two different views: Ports shows type, direction, tags, and warnings; Labels shows the label and sort columns instead. Each row is a bundle, such as an ATEM's Input 1 , and the Connection column shows which connection it belongs to. Expand a bundle to show its individual ports underneath. Tags apply to a whole bundle, not to the individual ports inside it. Example: label a port for the people using it An ATEM's native input names ("Input 1", "Input 2"...) don't mean anything to the people building positions or routing panels. Open Routing → Labels . Select the row (or rows) you want to relabel. Selecting several rows at once lets you label them together in the next step. Right-click the selection, then choose Labels → Edit User Label... . Enter a name in Label . If you selected multiple rows, use % in the text to auto-number them: for example, Camera % becomes Camera 1 , Camera 2 , and so on across the selected rows. Optionally set an Icon and Color . Select Apply . Buttons has three separate label types, each shown in its own column in the Labels view: User : the name people see day to day when building positions and routing panels. Setup : a name meaningful during installation or configuration, kept separate so it doesn't clutter the operator-facing User label. Installation : a site-specific name, useful when the same connection type is deployed identically across multiple venues. A port or bundle can have one label of each type at once. None of them change the connection's own name for that port: only what Buttons displays. Wherever a port is shown, in the Routing views, a Router Section or a Custom Router , you can choose which of these labels it displays. Set a custom sort order The Custom Sort column in the Labels view sets the order bundles appear in. This order is then used elsewhere: a Router Section with Sorting Mode set to Custom lists its sources and destinations in this order, and so do the lists in the Routing views. Setting it once here means every panel shows your bundles in the order operators expect, such as cameras first, then playback, then graphics. Open Routing → Labels . Select the bundle, or several bundles, you want to order. Enter a number in the Custom Sort column. Lower numbers come first. With several bundles selected, the number counts up across them, so entering 1 numbers them 1 , 2 , 3 and so on, in the order they appear in the table. Use Iterate values in the same cell for more control over the numbering, and Clear to remove a bundle's sort number. Custom Sort applies to bundles, not to the individual ports inside them. Understand a port's status The Ports view's columns tell you what a port is and whether it's ready to use: Direction : Source or Destination . Type : whether the port comes from a Connection or NMOS . The pill next to the port count shows its signal type (video, audio, data, or a mux of more than one) as reported by the connection module: also read-only. Warnings : a warning badge appears when a port can't currently be used, such as when its connection isn't in an OK state or an expected SDP couldn't be fetched. A Wired badge means the port is already used by a wire and might not be directly routable as a result. A Disabled badge means the owning connection itself is disabled. Hide ports you don't need Large connections can expose far more ports than you'll ever route. Select the rows you don't need, right-click, and choose Visibility → Hide . Hidden ports stay hidden until you select them again (via search or a filter) and choose Unhide : hiding doesn't delete anything. If you get stuck What you see What to try A port has no label yet. It falls back to its connection's native name until you set one: that's expected, not an error. A port shows a Warnings badge and won't route. Check the owning connection's status first: most port warnings trace back to the connection, not the port itself. A port shows a Wired badge. It's already claimed by a wire. See what that wire connects before trying to route it elsewhere. You can't find a port you know exists. Check whether it's hidden: search or filter for it, then Visibility → Unhide . Where to go next Take a physical route , once your ports are labeled the way you want.
