Appearance
Screens
Screens represent the display configurations for your TV devices. Each screen defines what content is shown — menu boards, advertisements, or both — and is published to one or more paired devices.
Creating a Screen
- Navigate to Screens in the sidebar.
- Click Add Screen.
- Fill in the screen details:
| Field | Required | Description |
|---|---|---|
| Name | Yes | A descriptive name (e.g., "Bar Area TV 1") |
| Screen Type | Yes | What kind of content this screen displays |
| Location | Yes | Which location this screen belongs to |
| Notes | No | Internal notes about this screen |
- Click Save.
Screen Types
| Type | Description |
|---|---|
| Menu Board | Displays menu content from your menu boards |
| Advertisement | Displays only advertisements from ad playlists |
| Split Screen | Shows a menu board and an ad playlist on the same display at the same time |
Screen Pages
Each screen can have multiple pages that rotate on the display. Pages let you show different menu boards or ad playlists in sequence.
Adding a Page
- Open a screen for editing.
- Click Add Page.
- Configure the page:
| Field | Description |
|---|---|
| Menu Board | Select a menu board to display on this page |
| Ad Playlist | Select an ad playlist to play on this page (optional) |
| Duration | How long this page displays before rotating to the next |
| Sort Order | The order in which pages rotate |
- Save the page.
Multiple Pages
When a screen has multiple pages, they rotate automatically:
- Page 1 displays for its configured duration.
- Then page 2 displays for its duration.
- The cycle repeats continuously.
This is useful for showing different menus (e.g., a food menu on one page and a drink menu on another) or rotating between menu content and advertisements.
Split Screen Pages
On a Split Screen screen, each page shows a menu board and an ad playlist together on the same display. Configure:
| Field | Description |
|---|---|
| Menu Board | The menu board to show (required) |
| Ad Playlist | The ad playlist to show alongside it (required) |
| Menu Ratio | How much of the screen the menu takes — 1/2 (50%) (default), 1/4 (25%), 2/3 (66%), or 3/4 (75%) |
| Orientation | Horizontal (menu and ads side by side) or Vertical (stacked top and bottom) |
| Duration | How long the page shows before rotating to the next |
Both a menu board and an ad playlist are required on a split-screen page.
Publishing a Screen
Publishing generates a configuration manifest that your Fire TV devices download and display.
How to Publish
- Go to Screens and open the screen you want to publish.
- Review the screen's pages and content.
- Click Publish.
What Happens When You Publish
- The system validates your configuration:
- At least one page must be configured. The Publish button is disabled until you add a page. (You can still save a screen with no pages, you just cannot publish it.)
- At least one device must be paired to the screen.
- All referenced content (menu boards, ad playlists) must be valid.
- A versioned manifest is generated containing all menu data, ad data, and display settings.
- The manifest is stored securely with a checksum for integrity verification.
- The version number increments automatically.
- Your paired devices pick up the new configuration on their next sync (typically within seconds).
Tracking the Rollout
Once you click Publish, a per-screen banner appears on the Screens list page (and a global indicator follows you across pages) showing exactly which devices have picked up the new version:
- Pending — online devices that have not yet synced the new manifest.
- Synced — online devices that confirmed the new version.
- Offline — devices that were offline at publish time. They will pick up the change when they next come online.
The banner clears for a screen as soon as every online device has confirmed the new version. Offline devices do not block completion, so a publish is considered "rolled out" once it has reached every device that is currently reachable. You can publish multiple screens in parallel and each gets its own banner.
Publish History
Each screen maintains a complete publish history:
- Version number — Incrementing version of the configuration.
- Status — Started, Succeeded, or Failed.
- Published by — Which user initiated the publish.
- Timestamp — When the publish occurred.
You can review this history in the screen edit view to track changes over time.
Editing a Screen
- Go to Screens.
- Click Edit next to the screen.
- Modify the screen details, pages, or content assignments.
- Click Save.
Important: Changes to a screen do not go live until you Publish. This means you can make updates safely without disrupting the current display.
Deleting a Screen
- Go to Screens.
- Click Delete next to the screen.
- Confirm the deletion.
Note: Devices paired to this screen will stop receiving content updates. You should reassign or revoke those devices.
Plan Limits
| Plan | Displays per Location |
|---|---|
| Sampler (Free) | 1 |
| Starter | 1 |
| Pro | 3 |
| Platinum | Unlimited |
See Billing & Subscriptions for upgrade options.