Skip to main content

Wire Scene Buttons onto a UI

Goal: put one-tap buttons on a panel that run scenes and modes — "Good Morning", "Movie Time", "Good Night".

Scene buttons are macros made accessible from a UI via UI Macros. The macro does the work; the UI macro is the button that runs it.

Before you start​

  • You're logged in as an administrator.
  • The macro to run exists (see Build a Macro).
  • The UI you're adding the button to exists (see Create a UI).

:::warning Turn off Elevated for user-facing scenes A button that ordinary users tap must run a macro with Elevated off, or only elevated users will be able to run it. See Build a Macro. :::

Steps​

  1. Open UI Macros.

    Open UI Macros

  2. Select a subsystem — this filters the macro list to relevant macros (e.g. "Lighting").

  3. Select the target UI — the panel you're adding the button to. The right panel shows macros already assigned to it.

  4. In the left panel, select the macro and configure how the button presents:

    • Display name — the button label users see.
    • Icon — pick an icon for the button.
    • Arguments — optional parameters passed to the macro when run.

  5. Click Add ▶ to add the macro to the UI.

  6. Use the ▲ ▼ buttons in the right panel to set the button order.

Verify it​

Open the UI (its View action) and tap the new button — the scene should run exactly as it does from the macro's Run action in the editor.