Linking cards

Switch on sync for cards with the same identifier and they stay the same on every dashboard.

On this page

Cards of the same type with the same Companion app identifier can be linked by switching on Sync with cards using this identifier. They are then one card shown in several places: change one and the others change with it, on every dashboard in your household.

Use it when the same thing belongs on more than one screen. The front door on the hallway panel and on your phone dashboard, or the same list of lights in a Multicard on three floors. You set it up once and maintain it in one place.

Linking cards

  1. Open the card you want to link and go to its Advanced tab.
  2. Under Companion app, give it the identifier the cards should share.
  3. Switch on Sync with cards using this identifier, read the note under the identifier field, then save.
  4. Do the same on every other card that should be linked.

Both are needed: the same type and identifier, and sync switched on for each card. The switch is off by default, so cards that only share an identifier stay separate, and a card with sync on leaves cards with sync off alone. Capitals and spaces around the identifier do not matter, so Kitchen-Light and kitchen-light are the same.

The identifier does not need to come from a flow or have anything to do with Homey. Linking works even if you never install the companion app.

Which card wins?

A card joining cards that are already syncing takes over their settings. What you filled in on that card is replaced, and the note under the identifier field warns you before you save. A Multicard also takes over the group's entries; its old entries go to the trash.

The first card to switch on sync keeps its settings, so start with the card you want the others to copy.

What stays the same across linked cards

Linked Per card
The device, flow or other source Position and size on the dashboard
Title and icon Which dashboard it is on
The settings on the General, Advanced and Style tabs
PIN codes and on-tap behaviour

Multicards

Switch on sync for the Multicards themselves and they keep the same list. Their entries follow without a switch of their own:

You do this in one Multicard The others
Add an entry Get the same entry
Remove an entry Lose that entry
Change or rename an entry Change with it
Reorder the entries Follow the new order

An entry can also sync on its own with other cards of its type, using the switch in that entry's settings.

Things to know

  • Cards are never linked for you. Cards that already shared an identifier stay separate until you switch on sync for each of them.
  • Sync needs an up-to-date app. Older versions of the app do not show the switch. They leave its setting as it is.
  • Everyone's changes count. A linked card changes even on dashboards the person making the change cannot edit themselves. If someone may edit one card in a group, they are editing all of them.
  • Removing a card only removes that one. Taking a card off a dashboard is about where it is shown, so the other linked cards stay. A Multicard entry is the exception, as above.
  • Moving and resizing stay per card. Rearranging one dashboard never disturbs another.
  • A linked card back from the trash catches up. It takes on any changes the group had while it was gone.
  • Copies are not linked. A duplicated card or dashboard gets new identifiers and has sync switched off, so you can change the copy freely. Type the original's identifier and switch on sync if you do want them linked.
  • Different types never link. A Device card and a Gauge with the same identifier are separate cards, though a flow addressing that identifier still reaches both.

Unlinking

Switch off sync or give the card a different identifier, and save. It keeps its current settings and stops following the group.

Linking and flows

A flow that changes a colour or title reaches every card with that identifier, whatever its type and whether sync is on or off. See the companion app for what flows can do.

Colours set by a flow are live and are not saved, so they apply to the cards a flow addresses rather than travelling through a link.

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