Advanced tab

On-tap behaviour, confirmation, companion identifier and PIN protection.

On this page

The Advanced tab is the same on every card. It controls what happens when the card is tapped, and what has to happen before that.

It has three sections: On tap behaviour, Companion app and PIN code. Device cards, and device rows in a Multicard, have a fourth: Background colour.

The Advanced tab, showing the On tap behaviour, Companion app and PIN code sections

On tap behaviour

Pick one of four options at the top of the section. A line under the choice explains what the selected option does.

Option What a tap does
Default The card's natural action — toggle the device, run the flow, and so on
None Nothing. The card becomes a display
Companion Sends a webhook to the Homey companion app, so a flow can decide what happens
Dashboard Opens another dashboard

On a Webview card, any option other than Default makes the embedded page view only, so the tap reaches the card instead of the page.

Default

What you want almost always. A light toggles, a flow runs, a lock unlocks.

None

Makes the card inert. Use it for readouts you do not want anyone pressing — a temperature tile on a wall panel at child height, for example.

Companion

The most flexible option. Instead of acting directly, the card tells Homey it was tapped, and a flow decides what to do.

This is how you get behaviour HDashboards has no setting for: one tap that runs a sequence, or a button whose meaning changes with the time of day. It requires the companion app installed on your Homey, and a Companion app identifier set on the card so the flow knows which card was pressed.

Dashboard

Turns the card into a navigation tile. Tap Select dashboard underneath to choose which one opens. Any card type can do this, not just the Dashboard card — a Title card or an Image card can open a dashboard too.

Companion app identifier

In the Companion app section. A name this card is known by to the companion app. It is used both to identify which card was tapped, and to target the card when a flow wants to change its colour or title.

A number is generated for you. Replacing it with something meaningful — kitchen-light, front-door — makes your Homey flows far easier to read later.

Switch on Sync with cards using this identifier to link cards of the same type with the same identifier: changing one changes them all, on every dashboard in your household. Switching it on when the identifier is already syncing elsewhere replaces this card's settings with those of the group, and the app warns you before you save. See Linking cards.

Needs confirmation?

Shows a yes/no prompt before the card acts. The switch sits under the tap options, and is hidden when the tap behaviour is None, because there is nothing to confirm.

Right for anything disruptive but not sensitive:

  • All lights off while people are still in the house.
  • A flow that resets or restarts something.
  • A heating change that is slow to undo.

It is a guard against a mis-tap, not a security measure — anyone can press Continue. For real protection use a PIN.

Lock with pincode

In the PIN code section. Requires a numeric code before the card will do anything. Turning it on reveals:

Setting What it does
Unlock time Seconds the card stays unlocked after a correct code
Code The accepted code. More can be added with Add code

This is covered in detail on its own page: PIN protection.

Colour the card by its state

In the Background colour section. On by default: a device that is on colours its card, and a light tints the card to match its own colour.

Switch it off when you want the card to keep its normal colour whatever the device is doing, for example to keep a wall panel calm in the evening. The icon still shows when the device is on.

Two colours still apply when it is off, because you asked for them yourself: a colour set by a flow through the companion app, and the orange of Turn orange when an alarm is active.

Choosing between confirmation and a PIN

Needs confirmation PIN
Stops accidental taps Yes Yes
Stops other people No Yes
Friction One tap Entering a code

Use confirmation for disruptive, a PIN for sensitive. Using a PIN everywhere makes a dashboard tiring; using it on the front door lock is exactly right.

Something unclear or out of date? Let us know or ask in the Discord community.