Skip to content
Treadle

Controls that take a value: toggles, levels and prompts

Updated October 1, 2026

Some controls carry a value you set, not just a press. A toggle is on or off, a level holds a number you slide, and a prompt takes text you type. You choose which a control is by setting its Kind in the Mac editor when you build it.

The four control kinds: a Button that fires once, a Toggle that is on or off, a Level that holds a number, and a Prompt that takes typed text.

The three kinds that take a value

  • Toggle — on or off. Good for a setting that has two states.
  • Level — a number across a range, for example the output volume from 0 to 100.
  • Prompt — typed text, for example the name of a new folder.

Set the Kind

  1. Open Edit decks… from the menu-bar popover on the Mac.
  2. Select the control you want to change.
  3. Set its Kind to Toggle, Level, or Prompt.
  4. Choose the action the value feeds into.

Two shipped examples

  • Set the output volume. Use a Level control so you can slide the volume between 0 and 100.
  • Make a new folder in a location you pick. Use a Prompt control so you can type the folder's name when you use it.

A note on prompts

A Prompt asks for the text on the iPad or iPhone when you use the control, then sends that text to the action on the Mac. As with every action, the iPad or iPhone sends the action's name and your value, never a command.

Live state indicators, which show the current value back on the control, are a paid feature. See What's free, what's paid.

Questions & answers

How do I choose the kind?
Set the control's Kind in the Mac editor. The device then shows the matching toggle, slider or text entry.
What is a plain button then?
A button simply fires its action once when pressed. Toggles, levels and prompts add a value on top of that.

Related