Name, location, and notes

The three fields that describe a screen, and why the ones that look like paperwork are the ones that save a site visit.

Name and location are on the screen's Settings tab, and both are required. Notes have a tab of their own, are optional, and are worth filling in anyway.

Name

The name is how the screen appears everywhere: the list, search, alerts, and the label created when it was paired. It can be up to 255 characters.

Name for where the screen is, not for what it shows. What it shows changes; where it is does not. Frankfurt reception left survives a rebrand. Q3 campaign does not survive Q4.

Consistency matters more than cleverness. If names share a shape, Site, room, position, then searching for a site lists everything in it.

Location

An address, chosen from suggestions as you type, which also stores coordinates.

It matters for two reasons beyond record-keeping: it is what tells you where a screen physically is when someone has to go to it, and it is how the screen's time zone is understood when you are reading its local time against a schedule.

A change to the name or location reaches the apps playing on the screen right away, so an app that shows either one stays current.

Notes

Under Screens > a screen > Notes, visible to everyone in the workspace.

This is for the things that are true of the physical installation and recorded nowhere else. Which cabinet the player is in. That the socket is switched at the wall. Who has the key. Which port on the switch it is plugged into. Which display input it is on.

The test is whether it would save someone a phone call at the site. If so, it belongs here.

The editor has a formatting toolbar, and notes show as formatted text: headings, bullet and numbered lists, quotes, and links you can click. Markdown you paste in keeps its formatting. Notes can run to 65,536 characters, so a full installation record fits.

Notes are not copied when you copy settings from another screen, and the screens list search does not look in them.

For developers

On API v4.1, notes are the screen's description field, which takes up to 65,536 characters. Saving a screen whose name or location is over 255 characters, or whose notes are over 65,536, returns an error that names the field and its limit.