Pages

A screen shows one page at a time. A page is a grid of cells, and every tile takes one cell or more. How many cells a page has depends on the screen.

Change the grid ​

Open your screen's Layout tab. The Grid button beside the pages shows the current columns and rows, such as 2 × 3.

  1. Open Grid and use the − and + buttons beside Columns and Rows.
  2. On a rectangular screen, choose Landscape or Portrait under Way if you want to turn it.
  3. Review the tiles in the preview and press Save & send.

The screen gets the new grid with the layout. No new firmware build is needed. Changing orientation restarts the screen once; changing only the number of cells does not.

Each axis starts at a minimum of one cell. The maximum depends on the board and orientation, up to eight columns and eight rows. The buttons stop at the range your screen reports. More cells fit more small tiles; fewer cells give each tile more room. The default is the suggested grid in the table below.

If a tile no longer fits, the editor moves it to a new page directly after its original page. A tile that is too large for the new grid is reduced to a size that fits. Nothing is sent until you save. If the layout would need more pages than the screen supports, the change is refused and the layout stays as it was. Returning to a larger grid does not automatically merge those extra pages.

This needs app 0.4.85 and firmware 0.53.0 or newer. Older firmware shows Update this screen to choose its grid here. Update it before changing the grid. Once Tessera knows a screen's supported grids, you can edit its layout while it is offline; it receives the changes when it reconnects.

Suggested grids ​

These are starting points, not fixed tile limits. Columns × rows:

ScreenLandscapePortrait
CYD 2.8 inch, both display profiles2 × 31 × 4
Guition 3.5 inch, Waveshare 3.5 inch2 × 21 × 3
Guition 4 inch, Waveshare 4 inch, Waveshare P4 86 panel2 × 32 × 3
Hosyond 4 inch2 × 31 × 4
M5Stack Tab5, Guition 5 inch, Waveshare 5 inch3 × 31 × 5
Waveshare 4.3 inch, Guition P4 4.3 inch3 × 31 × 4
Guition 7 inch, Sunton 7 inch, Waveshare LCD-7 and LCD-7B4 × 42 × 7
Guition 10.1 inch, all revisions5 × 55 × 5
reTerminal D10015 × 53 × 8

Page and tile capacity ​

Changing the grid does not change the total page or tile capacity of the board:

ScreensPagesTiles in total
CYD, both profiles; Hosyond; M5Stack Tab5864
Guition P4 4.3, 7 and 10.1 inch, all revisions; reTerminal D100116256
Guition 3.5, 4 and 5 inch; Sunton; all Waveshare profiles24128

The editor also checks memory use. A forecast, thermostat or media tile can take more memory than a light or switch. On a small grid, the available cells can run out before the tile limit. For example, the CYD's suggested landscape grid has room for 48 single-cell tiles across eight pages.

Titles and the Home page ​

Every page can have a Page title, shown in the top bar. A page without one shows the Screen title, and a screen with an empty title shows the logo alone.

One page is the Home page: where the home key goes, where the screen returns to by itself after a while, and where it starts. Page 1 is Home unless you choose another page with Set as Home.

Pages the bar doesn't show ​

Turn off Show in page dots and swipe navigation in a page's settings and it becomes a detail page. The page bar skips it, and you reach it through a Go to page tile or from an automation. Its page bar shows Back, which returns the way you came.

Working with pages in the editor ​

  • Add page in the toolbar above the pages. It asks for a title and what the top bar shows. Dropping a tile on the empty page after the last one also makes a page, without questions.
  • Drag a page by its number to change the order. Its tiles, title and links travel with it.
  • The ··· menu of a page: Page settings, Edit top bar, Set as Home, Duplicate page, New empty page with this top bar and Remove page. A removed page can be brought back with Undo in the message that appears.
  • Row shows the pages side by side; Map shows how they link to each other.

Empty cells stay empty where you leave them. Nothing is drawn there on the screen.

Getting around ​

How people move between pages on the glass is set per screen: the page bar, swiping, the home key. Navigation explains those settings, and On the screen what each one looks like.