# Dashboard settings

> What one screen declares about itself in the editor's Dashboard area: name, description, icon, the grid it composes on, the startup flag, the status bar in full screen, who sees it, and how it is deleted.

The **Dashboard** area of the [editor](view-editor)'s tool rail holds the settings that
belong to the screen itself rather than to any component on it. It opens only when you
choose it, and it saves as the other areas do: a text field when you leave it, a switch
when you flip it. Like the whole editor it needs the **Edit dashboards** permission and a
station that takes writes. On a screen of your own its heading reads "General settings for
this operator screen."; on a screen defined on a Process model it reads "This screen
belongs to a Process model. One definition serves every unit of it: each unit opens it over
its own bound channels."

## The settings {#the-settings}

| Field | What it is | Values / default | Effect |
|---|---|---|---|
| Name | The screen's name in the Visualization column, on the stage bar and on the folder overview card. | Free text; "New dashboard" at creation | Renames the row everywhere at once, on every connection. Two screens may share a name. |
| Description | One line telling two screens of similar name apart. | Free text; empty | The row's tooltip in the column and the second line of the folder overview card. |
| Icon | The screen's own mark, drawn before its name in the column, on the stage bar and on the overview card. The button carries the mark that was named ("Icon" while none is); pressing it unfolds a grid you narrow with **Icon (search by name or tag)** ("oven, pump, water…"). The first cell of the grid is **No icon**. | A name of the icon library, or none | The library name is stored, never the glyph, so the mark reads the same wherever the screen opens; a name the library does not carry draws nothing. Choosing a cell closes the grid; a press outside it closes it too. |
| Columns / Rows | The grid the screen composes on. | 1 to 96 each; 24 × 12 | Redraws the grid at once. A value outside the band is refused with "Columns and rows must be between 1 and 96."; a shrink that would push any component out of the grid is refused with "Resize rejected: a component would fall outside the new grid." and nothing moves. |
| Show at startup | Marks this screen as the one every connection opens on. | on / off; off | At most one screen carries the flag: turning it on clears it on every other screen. With none flagged the first screen in list order opens. Not offered on a model's screen, which opens from a unit. |
| Show status bar in full screen | Whether the station status bar stays visible while this screen runs full screen or expanded. | on / off; on | Turning it off shows the note: "Full screen will hide communication and server health, alarms, active and held runs, license and runtime status, the station clock, and the results the status bar reports. Buttons, toggles and inputs still answer on the component itself." Normal mode always shows the bar; see [Fullscreen operator mode](view-fullscreen). |
| Visible to | The roles that list and open this screen, one tick box per role. Admin is not listed, because it always sees every screen; "Not signed in" is. | Role checklist; none checked | "With no roles checked, everyone sees this dashboard. Admin always sees every dashboard." A checked list narrows the screen to those roles, in the column and by its `/d/{id}` address alike. Not offered on a model's screen. |

A copy of a screen inherits every setting of its source except the startup flag, which
stays with the original.

## Deleting a dashboard {#deleting-a-dashboard}

**Delete dashboard** stands at the foot of the area in its own danger zone: "Removes this
screen and all of its components." The **Delete** button asks first, naming the screen:
"This removes the screen and everything on it (its components and their connections). The
addresses they read stay in Logic." A refusal keeps the screen; a confirmed deletion
removes it for every connection at once, the editor closes, and the page lands on the
screen it would otherwise have opened. A screen deleted here cannot be undone from the
status bar: the one-level Undo is for components and connections, not for screens.

## What is not here {#what-is-not-here}

- **The folder** a screen is filed under is not a setting: file it from its row in the
  Visualization column ([Screens and folders](view-screens)).
- **The order** among its siblings is the footer's Move up / Move down while the editor is
  open.
- **Show on View** is not asked of a screen of your own, which is always in the list; it is
  the switch on a model's Panels or Dashboards row in the Process workspace
  ([Dashboards of a model](process-dashboards)), and a unit's entry on View has no settings
  area at all.
- **A model binding** is not chosen here: a screen belongs to a model because it was
  created on that model's Dashboards row, and a screen of your own never becomes a
  model's. What the binding changes in the editor (the abstract channels leading every
  address list) is on [The dashboard editor](view-editor).
- The appearance of the components (frame, background, title, scale) is theirs:
  [Dashboard components](components).