Skip to main content

Devices

Devices are the physical display screens (TVs, monitors, digital signs) that show your content. Each device belongs to a device group.

Device Status Page​

Monitor all your devices from a single view.

Navigate to: Visit /devices/status directly, or click a "Device Status Report" notification if you have offline devices

Status Summary​

At the top, a summary card shows:

  • Offline - Number of devices currently offline
  • Critical - Devices offline for over 24 hours
  • Online - Number of devices currently connected

If all devices are online, you'll see an "All Devices Online" message instead.

Offline Devices by Store​

Below the summary, offline devices are grouped by store location. Each store section shows:

  • Store name and offline device count
  • Device groups within that store
  • Individual offline devices with their offline duration (e.g., "2 hours", "3 days", "Never connected")

Critical devices (offline 24+ hours) are highlighted in red. Click any device name to open its detail page.

Refresh Status​

Click Refresh Status to update the page with the latest device status information.

Device Detail Page​

Click any device to view its full details.

The page header shows:

  • Device name (or "Unnamed Device" if not set)
  • Device ID
  • Real-time Online/Offline status indicator (for registered devices)

Information Cards​

The detail page displays organized information:

Device Card​

  • Device name
  • Order position in device group (e.g., "Position 1")
  • Created date

Device Group Card​

  • Device group name
  • Sync status badge
  • "View/Edit Content" link to the device group editor
  • Device slot count

Published Template Card​

  • Template name (if a template has been published to the device group)
  • "View/Edit Template" link to the template editor
  • Last updated date

If no template has been published, displays "No template has been published to this device group yet."

Store Card​

  • Store name
  • Location (city, province)
  • Street address

Company Card​

  • Company name

Device Actions​

Sync Now​

Force a device to download the latest content:

  1. Open the device detail page
  2. Click Sync Now
  3. Wait for confirmation

Use this when:

  • A device isn't showing updated content
  • You need immediate content refresh
  • Troubleshooting connectivity issues

Unregister Device​

Remove a device from its device group:

  1. Open the device detail page
  2. Click Unregister Device
  3. Review the confirmation dialog explaining the device will need to be re-registered via QR code
  4. Click Unregister to confirm

After unregistering:

  • The device slot becomes a placeholder
  • The physical device shows the registration screen
  • You can register a different device to that slot

Quick Actions​

The device page provides shortcuts:

  • Edit Device Group Content - Jump directly to content editing
  • Edit Template - Open the linked template (if published)

Placeholder Devices​

When a device group is created, slots start as placeholders:

  • In the device group editor, placeholders show a "placeholder" badge next to the device name
  • Placeholders don't have a device info link (you can only view details for registered devices)
  • Register a device to convert a placeholder to an active device

Device Registration Flow​

  1. Physical device displays a 6-character code
  2. User enters code at /register
  3. User selects store and device group
  4. Device links to the selected slot

See Device Setup for detailed registration instructions.

Sync Status Badges​

On the device page, sync status refers to the device group's template sync:

BadgeMeaning
In SyncDevice group matches published template
Manually EditedDevice group was edited directly
Template UpdatedTemplate changed, needs republish
Not PublishedNo template published to device group

Troubleshooting​

Device Shows as Offline​

  1. Check the device's internet connection
  2. Verify power supply
  3. Try the Sync Now action
  4. If problems persist, unregister and re-register the device

Content Not Updating​

  1. Verify the template was published to the device group
  2. Use Sync Now on the device
  3. Check the device group's sync status
  4. Ensure media files uploaded successfully

Device Won't Register​

  1. Verify the registration code hasn't expired (codes are time-limited)
  2. Refresh the device screen to get a new code
  3. Ensure you're logged in with access to the target device group

Permissions​

All authenticated users can view devices and use Sync Now. Unregistering devices is available to all users with access to the device group.