Bitfocus AS
logo
logo
Bitfocus AS
logo
logo

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
Co-funded by the European Union

Our Bitfocus Workflow 2.0 project is co-funded by the European Union’s Creative Europe programme. About the project

© 2026 Bitfocus AS. All rights reserved.

  1. Home
  2. Academy
  3. Buttons Foundations
  4. Variables and feedbacks

Section 3 of 710 min

Variables and feedbacks

The difference between a variable and a feedback, the three types of feedback, and how they work together on one button.

After this section you can:

  • Tell a variable from a feedback on a described control.
  • Say what each of the three feedback types (boolean, advanced and value) can do on a button.
  • Explain how a variable and a feedback can work together on one button.
Variables and feedbacks both tell you something about the state of a device, so they're easy to mix up. Mixing them up is one of the most common mistakes people make when they start with Buttons. This section is about telling them apart.

The short version#

  • A variable is a value: Camera 2, -12 dB, slide 7 of 24. You show it in a button's text, use it in a calculation, pass it to an action or use it in a workflow.
  • A feedback is a report of state that can change how a button looks: a button turns red when its camera is on air, or shows a thumbnail of the clip that's loaded.
A useful question to ask: do I want to show a value, or do I want the button to change when something is true? Showing a value calls for a variable. Changing the button calls for a feedback.

The three types of feedback#

The connection's module decides which type each of its feedbacks is. The type decides what it can do on a button:
Type
What it reports
What it can do on a button
Boolean
On or off: a mute is active, a source is on Program
When on, it applies the text, colours and image you set on the feedback
Advanced
A result from the module, sometimes with an image such as a clip thumbnail
Any result counts as on, so your styling applies. An image is shown on the button
Value
A value: an audio level, a timecode, a name
It can't change the button's look by itself. Store it in a Feedback variable on the button and show it in the text, for example $(self.state.level)
The value type is where the line between the two ideas blurs: a value feedback is shown on a button through a variable.
A value feedback in use: the audio level is stored in a Feedback variable named masterlevel and shown in the button's text.

Working together#

Most useful buttons use both. Picture a button on a vision mixing panel:
  • Its text reads Camera 2. That comes from a variable: the name of the source.
  • It turns red when Camera 2 is on Program. That's a feedback: a boolean report that Camera 2 is on air.
If you removed the feedback, the text would still update when the source name changed. If you removed the variable, the button would still turn red, but it would no longer show the name. They're two separate jobs.
Another example: a playback button shows slide 7 of 24 from a variable, while a feedback changes its colour while the slideshow is running.
Feedbacks and variables on a real panel. The red buttons and the still image come from feedbacks; the level -100 comes from a variable.
Read more in the docs:What is Bitfocus Buttons?,Add more feedback to a button

Try it

In your own Buttons installation.

Look at the variables and feedbacks of the Practice ATEM connection you created in section 1.
  1. Open Connect → Connection and select Practice ATEM.
  2. Open the Feedbacks tab. Each entry has a name and a description. Find a feedback that reports whether an input is on Program, such as Tally: Program. It's a boolean feedback: on air or not.
Tally: Program is at the top of the Feedbacks tab.
  1. Open the Variables tab. Find the variable that holds the current program input, such as pgm1_input. It holds a value, not an on/off state. Because the connection isn't connected to a switcher, it shows a default value such as Black, not a real program input.
pgm1_input on the Variables tab. This switcher was connected, so it shows CAM2; yours shows a default value instead.
  1. For each of these, decide whether you'd use a variable or a feedback:
  • Show which input is on Preview as text.
  • Make a button flash when the ATEM is recording.
  • Show the current audio master level as a number.
Check your answers: the first is a variable. The second is a boolean feedback. The third is a value feedback, which you show through a Feedback variable, or a connection variable if the module provides one.

Quiz

Answer the questions for this section. You need 80% to move on.

  1. Question 1
    1.

    A button shows Camera 2 as text and turns green when Camera 2 is on air. Which part is the variable?

  2. Question 2
    2.

    In the same button, what happens if you remove the feedback but keep the variable?

  3. Question 3
    3.

    You want a button to show the current audio level, such as -12 dB, as text. The module offers it as a value feedback. How do you show it?

  4. Question 4
    4.

    Which feedback type can show an image, such as a clip thumbnail, on the button?

  5. Question 5
    5.

    Which of these need a feedback rather than a variable? Select all that apply.

0 of 5 answered

PreviousPositions and surfacesNextRouting basics
Buttons Foundations
  1. 1What Buttons is
  2. 2Positions and surfaces
  3. 3Variables and feedbacks
  4. 4Routing basics
  5. 5Finding your way around
  6. 6Choosing a control method
  7. 7Wrap-up and final quiz

In this section

  • The short version
  • The three types of feedback
  • Working together
  • Try it
  • Quiz