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 directly, or click a “Device Status Report” notification if you have offline devices

Status Summary

At the top, a summary card shows:

• Needs Attention - Number of devices that are offline or haven’t synced recently
• Critical - Devices that haven’t synced for over 24 hours
• Online & Synced - Number of devices currently connected and up to date

If all devices are online and synced, you’ll see an “All Devices Online” message instead.

Critical Alert

When devices have been offline for more than 24 hours, a critical alert banner appears with guidance to check connectivity and power.

Devices by Store

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

• Store name and device count
• Device groups within that store (clickable links to device group pages)
• Individual devices with both their connection status and sync status

For each device, you’ll see:

• Online/Offline indicator - Shows real-time connection status (Wifi icon for online, WifiOff icon for offline)
• Last synced time - Shows when the device last fetched content (e.g., “2 hours ago”, “3 days ago”, “Never synced”)

Critical devices (haven’t synced for 24+ hours) are highlighted in red with an X icon. Non-critical devices show an orange warning icon. Click any device name to open its detail page.

Refresh Status

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

Understanding Status Indicators

• Online means the device is currently connected to the server
• Last synced shows when the device last fetched content from the server
• A device can be online but not recently synced (or vice versa)
• Devices are shown on this page if they’re offline OR haven’t synced within the configured threshold (default: 48 hours)
• Critical status indicates devices that haven’t synced for more than 24 hours

Device Detail Page

Click any device to view its full details.

Header

The page header shows:

• Device name (or “Unnamed Device” if not set)
• Device ID
• Real-time Online/Offline status indicator (for registered devices only - not shown for placeholder devices)

Information Cards

The detail page displays organized information in a two-column layout on desktop:

Device Card

• Device name (or “No name assigned”)
• 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

Metadata

• Last updated timestamp for the device

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 the “Sync command sent” 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:

• You are redirected to the device group page
• 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 in the right column:

• 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
• On the device detail page, placeholder devices display a message: “This is a placeholder device slot. Register a device via QR code to enable actions.”
• Placeholder devices don’t show the online/offline status indicator
• Sync and Unregister actions are not available for placeholder 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 the registration page
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:

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.