Device Groups

A device group is a collection of display devices, typically located together at a single store location. You assign content to device groups, and all devices in the group display that content.

Viewing Device Groups

Device groups appear on the home page alongside templates. You can also access them from:

• Home page - Shows all device groups with sync status
• Settings > Device Groups - Admin view with management options
• Store Details - Shows device groups for a specific store

Creating a Device Group

Requires: Admin or Manager role

1. Navigate to Settings > Device Groups
2. Click Add Device Group
3. Select a Store - The location for this device group
4. Enter a Device Group Name - Descriptive name (e.g., "Main Floor Screens")
5. Set Number of Device Slots - How many placeholder slots to create (1-20)
6. Click Create Device Group

Device Group Editor

Click any device group from the home page to open the editor. This uses the same interface as templates.

Device Slots

Each slot represents a physical screen position:

• Placeholder slots are waiting for a device to register
• Registered devices show the device name and status
• Add or remove slots as needed

Assigning Content

For each device slot:

1. Click + Add content at the bottom of the device column
2. Browse or search your media library
3. Select one or more media items and click Add
4. Set display duration for each item
5. Drag items to reorder playback sequence

Note: Device groups only support media directly - you cannot add scripts to a device group. When you publish a template containing scripts to a device group, the script's media items are expanded into individual entries.

Scheduling

Configure when content displays:

• All Day - Content plays continuously (default)
• Time Range - Specific start and end times
• Date Range - Limit to specific dates
• Recurrence - Daily, weekly, or custom patterns
• Exceptions - Exclude specific dates

Sync Status

Device groups track their relationship with templates:

Status	Meaning
In Sync	Content matches the last published template
Edited	You've edited the device group directly after a template publish
Update available	The template was updated but not republished here
No template	No template has been published to this group

Linking to Templates

Device groups can receive content from templates:

1. Create or edit a template with your content
2. Open the template and click Publish
3. Use the quick publish dialog or click Advanced: Select specific device groups
4. Select the device groups you want to update
5. Click Publish Template (quick) or Publish Selected (advanced)

After publishing, the device group shows as "In Sync" with that template.

Direct Editing vs Templates

You can edit device group content directly, but:

• Direct edits mark the group as "Edited"
• Re-publishing a template overwrites direct edits
• For consistent content across locations, use templates

Managing Device Groups

From Settings

Settings > Device Groups (Admin only) shows:

• All device groups organized by store
• Device count for each group
• Filter by store
• Create, edit, or delete groups

Deleting a Device Group

1. Open Settings > Device Groups
2. Click the device group to edit
3. Click Delete
4. Confirm deletion

Warning: Deleting a device group removes all associated devices and content assignments.

Permissions

Action	Required Role
View device groups	All users
Edit content	All users
Create device group	Admin
Delete device group	Admin