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.

Add a Popover 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
← Organize controls with a Folder Section
Next
Build and reuse a Shared Section →
Contact support →
You are viewing documentation for Buttons 1.8.See the docs for Buttons 1.6
Buttons/Positions/Add a Popover Section

Add a Popover Section

Buttons doesn't make you choose between a clean layout and having everything available: a Popover keeps rarely-used controls one tap away without cluttering the canvas the rest of the time. This page covers creating a Popover, customizing how it opens and where it appears, and controlling it from elsewhere in the position.

Before you begin#

Create a position to add the Popover to.

Create a Popover#

  1. Select the cell where you want the Popover's trigger button.
  1. Click and drag to also select the cells the unfolded Popover should occupy.
  1. Right-click the selection, then choose Create... → Popover.
Even though you selected multiple cells, only the trigger button occupies space until the Popover opens: the rest of the selected area stays free for other controls.

Customize its appearance#

Select the Popover and use the Design tab to set the trigger button's own Layout, Icon, Text, and colors under Button Styling, plus the expanded section's own colors under Section Styling.
A separate settings tab controls the Popover itself:
  • Dimensions: the width and height of the unfolded section.
  • Snap to: where the unfolded section anchors. Button (the default) anchors it to the trigger button itself, and unlocks the Placement and Fit Surface options below. Absolute Position anchors it to a fixed spot on the canvas instead: turn on Position Offset and its X/Y become the section's exact canvas coordinates, so it always opens in the same place no matter where the trigger button sits. Choosing one of the Surface 1–8 options anchors it to a corner of that specific attached surface instead, and replaces Placement with a Corner picker (Top Left/Top Right/Bottom Left/Bottom Right).
  • Placement: (Snap to: Button only) which direction the section unfolds from the trigger button, chosen from a compass of eight directions.
  • Fit Surface: (Snap to: Button only, and only while Position Offset is off) whether the section is allowed to reposition itself to stay fully visible. Auto Fit Position flips the unfold direction away from Placement when the configured direction would run off the edge of the canvas. Force Placement always unfolds in the exact configured direction, even if that clips part of the section off the edge.
  • Position Offset: move the unfolded section away from the trigger button to any position on the canvas, instead of unfolding right next to it. For Snap to: Absolute Position, this is the only way to set where the section appears.
  • Animation: (Snap to: Button only) turn the open/close animation on or off.
  • Dismiss on click: automatically close the Popover after a button inside it is pressed.
  • Momentary: instead of toggling open and closed on separate presses, the trigger opens the section on press and closes it again as soon as it's released, like a hold-to-show control.
A Popover can also scroll its own content: on the Navigation tab, turn Scroll on to let the section's contents scroll vertically when they don't fit, with a Scrollbar option to show it automatically, hide it, or pin it to the left or right edge.

Open, close, and control the Popover#

The trigger button opens and closes the Popover by default when pressed. Its Press/Release action handlers sit alongside two Popover-specific ones, Open and Close, so you can attach additional actions that fire specifically when the Popover opens or closes, beyond the open/close behavior itself.
To control a Popover from a different button, use the internal action Set Popover State:
  1. On the button that should control it, add the Set Popover State action.
  2. Under Popover, select which Popover it targets.
  3. Under Command, choose Open, Closed, or Toggle.
This lets one button open a Popover, a different button close it, or a single button toggle it: useful when the trigger you want people to use isn't the Popover's own button.

If you get stuck#

What you see
What to try
The Popover won't stay open after you click elsewhere.
Check Dismiss on click: it closes the Popover as soon as a button inside it is pressed, which can look like it closed on its own.
The Popover overlaps other controls when it opens.
Adjust Placement or turn on Position Offset to move it away from crowded areas.
A different button's Set Popover State action doesn't seem to do anything.
Confirm Popover is set to the Popover you meant: a control left at its default can silently target nothing.

Where to go next#

  • Organize controls in a section, for controls that should be visible all the time instead of tucked away.

Was this helpful?

Was this helpful?

0 of 0 users found this page helpful