Skip to main content

Scripts

Scripts are ordered playlists of media items that play in sequence. Use scripts to group related content that you want to reuse across multiple templates.

Accessing Scripts​

Click Scripts in the top navigation bar to open the Scripts page.

The gallery displays all your scripts as cards showing:

  • Script name
  • Number of media items
  • Preview thumbnail (first media item)

Search and Filter​

  • Search - Find scripts by name or tags
  • Tag Filter - Select one or more tags to narrow results
  • Sort - Order by created date, updated date, or name (ascending/descending)

Creating a Script​

Scripts are created in the Template Editor by grouping media items together:

  1. Open a template in the editor (or create a new one)
  2. Add multiple media items to a device slot using + Add content
  3. Select 2 or more contiguous media items (Shift+Click to select a range)
  4. A selection bar appears at the top
  5. Click Group as Script
  6. Enter a name for your script
  7. Click Create
  8. Save the template to persist the script

The new script now appears in both the template and the Scripts gallery.

Script Editor​

Click any script card to open the editor.

Script Details Panel​

The top section shows:

  • Name - Editable name field
  • Script ID - Unique identifier
  • Tags - Add or remove organizational tags
  • Media Count - Number of items in the script
  • Timestamp Information - Created date and last updated date
  • Save Changes button - Saves your modifications

Media Items Section​

This section shows all media in the script's playlist:

  • Each card displays a thumbnail, position number, and media name
  • Drag handle (left side) - Drag to reorder items
  • Remove button (X) - Remove item from script
  • Click a card to view that media's detail page

Adding Media​

  1. Click Add Media button
  2. Browse or search your media library
  3. Select one or more items (Ctrl+Click for multiple, Shift+Click for range)
  4. Click Add to confirm

Media is added to the end of the playlist. Drag to reorder as needed.

Reordering Media​

Drag and drop media cards to change the playback order:

  1. Grab the drag handle (⠿) on the left side of a card
  2. Drag to the new position
  3. Release to drop

Position numbers update automatically.

Removing Media​

Click the X button on any media card to remove it from the script. The media file itself is not deleted, only removed from this playlist.

Where This Script Is Used​

The bottom section shows which templates use this script:

  • Templates - List of templates containing this script
  • Device Groups - Device groups linked to those templates

This helps you understand the impact of changes before saving.

Script Actions​

Swap Script​

Replace this script with another across all templates:

  1. Click Swap... button (appears in the "Where This Script Is Used" section when the script is in use)
  2. Click Browse to search and select a replacement script
  3. Choose what to do with the original script after swapping:
    • Keep original script - Leave the original in your library
    • Delete original script - Remove the original after swapping
  4. Click Swap Script to confirm

For more control over which templates to update, click Advanced: Select specific templates to go to the full swap page.

Delete Script​

  1. Click Delete Script button
  2. A confirmation dialog appears with a warning that this action cannot be undone
  3. If the script is in use, you'll see how many templates will be affected
    • Click Swap script instead to replace the script first (opens swap dialog)
    • Or click Delete Script to proceed with deletion
  4. The script is permanently deleted

Warning: Deleting a script removes it from all templates that use it. This cannot be undone.

Publishing Script Changes​

When you save changes to a script that's used in templates:

  1. A dialog titled "Publish Script Changes?" appears
  2. Shows all templates using this script and how many device groups will be updated
  3. Click Publish Changes to update all affected device groups
  4. Or click Skip to save without republishing

Skipping means devices will continue showing the old content until you manually publish those templates.

Stale Data Warning​

If another user edits the same script while you're viewing it, a warning banner appears:

  • Refresh - Reload to see their changes (discards your unsaved changes)
  • Dismiss - Continue editing (may overwrite their changes when you save)

Permissions​

All authenticated users can view, create, and edit scripts for their company.