The editor

Tessera, the page in the Home Assistant sidebar, is where you arrange your screens. The sidebar lists your screens; a screen opens with Layout and Screen settings. Builds with plugins enabled also have a Plugins tab.

The editor with a screen open

Layout ​

The pages of the screen stand side by side, drawn as the screen draws them, with the real values from Home Assistant. The Library along the bottom holds everything in your home: search by name, device or room, or narrow it with the kind chips and the room filter. Hide placed leaves out what is already on this screen.

  • Add a tile by dragging an entity onto a cell, or click an empty cell and then an entity. Dropping on the empty page after the last one starts a new page.
  • Move a tile by dragging it. Drop it on another tile and the two swap. Arrow keys move a selected tile.
  • Rename with Name on the screen at the start of the tile's settings. You can also choose Rename from its menu or double-click its name in the layout. The reset button restores Home Assistant's name.
  • Resize with the handles on the right and bottom edge.
  • Remove with the tile's ··· menu. Undo in the message brings it back.
  • Undo and Redo in the toolbar step through every change.

Nothing reaches the screen until you click Save & send. Then you see "Saved · sent to screen", and the screen shows the new pages within seconds. A screen that is offline gets them when it is back. If someone else saved the same screen in between, the editor says so and lets you load their version or keep yours.

Change the grid ​

The grid button beside the pages shows the current columns and rows, such as 2 × 3. Open it to change Columns, Rows or, on a rectangular screen, Landscape and Portrait. A change stays in your draft until Save & send. It does not require a firmware build. See Pages for the supported range and what happens to tiles that no longer fit.

Find and repair missing entities ​

The screen list flags tiles whose entity has disappeared or stayed unavailable. Choose Review to see them, then Show another entity to select a replacement. A tile's settings also offer Choose another entity. The new entity keeps the tile's place; save the layout to send the change.

Unsaved work and connection ​

Layout changes are kept in this browser as you work. After a reload or reopening the tab, Restore brings unsaved work back and Discard removes it. This recovery does not send anything to the screen until you save.

If another tab in the same browser has unsaved work on this screen, the editor tells you. Take over here brings those changes into this tab. Keep mine keeps the work already open here.

While the app restarts or the connection is lost, a message explains that your changes stay. Connection restored appears when it is reachable again. Undo and Redo name the change they will apply.

The screen's menu ​

The ··· next to the screen's name:

  • Identify blinks the screen, so you know which one it is.
  • Read current data shows what Home Assistant reports for every tile, and how each tile is set.
  • Copy layout from… another screen, Export layout and Import layout… as a file.
  • Rename changes the name in the app.
  • Override YAML is for people who build their own firmware changes; see Flash a screen yourself.
  • Update firmware builds and installs the screen's firmware over Wi-Fi; see Updates.
  • Remove screen takes the screen out of the app and out of Home Assistant; see Manage your screens.

Preview ​

Preview above the pages opens the screen as it will behave: tap, hold and swipe as on the glass. It is the screen's own firmware, running in your browser, drawn from the layout you are editing. It follows the language under Settings → Language & region and the screen's Dark mode setting. Nothing is saved from it. Taps control devices sends the taps to Home Assistant for real; off, it only moves through the pages.

Settings ​

Settings in the sidebar holds what applies to every screen: Language & region (Clock, language and formats), Firmware updates (Updates) and Alerts (Alerts from automations).

On a phone ​

On a phone the editor shows the screen itself, one page at a time. Swipe for the next page; the page name under the screen opens the list of pages. Add tile opens a sheet with the search and the kinds, and says where the tile will go. A tap on a tile gives its name, icon and colour, with Move and Remove, and More settings for the rest. Full editor switches to the desktop editor; Simple view goes back.

Your screens on a phone, each with a preview of its first page
One screen on a phone, with Add tile
A tile tapped on a phone: its icon, colour, Move and Remove
Add tile on a phone: search, the kinds, the home's devices by room

Keyboard ​

⌘K or Ctrl+K opens a search over screens, entities, pages and actions. It can open a screen or page, add an entity, identify or update a screen, and find plugin actions that are available for your setup. A selected tile moves with the arrow keys and opens with Enter; a selected handle resizes with the arrows.