Publish Docs

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
  • Tags associated with the script

Search and Filter

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

Infinite Scroll

The gallery loads scripts in batches as you scroll. When you reach the bottom, more scripts load automatically until all matching scripts are displayed.

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 showing the number of selected items
  5. Click Group as Script
  6. Enter a name for your script (the name is validated to ensure uniqueness)
  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 (click to edit inline)
  • Script ID - Unique identifier
  • Tags - Add or remove organizational tags using the tag selector
  • Media Count - Number of items in the script
  • Timestamp Information - Created date and last updated date
  • Save Changes button - Saves your modifications (disabled when no changes)
  • Unsaved changes indicator - Appears when you have pending changes

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 (always visible on touch devices)
  • Remove button (X) - Remove item from script (always visible on touch devices, appears on hover for desktop)
  • Click a card to view that media’s detail page

Adding Media

  1. Click Add Media button
  2. Browse or search your media library in the dialog
  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. On touch devices, press and hold briefly before dragging.

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 and device groups use this script:

  • Templates - List of templates containing this script (links to template editor)
  • Device Groups - Device groups linked to those templates (links to device group pages with store names)

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 when the script is used in at least one template)
  2. Click Browse to open the script selection dialog
  3. Search and select a replacement script
  4. Choose what to do with the original script after swapping:
    • Keep original script - Leave the original in your library
    • Delete original script - Permanently delete the original after swapping
  5. 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 and removed from all templates

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 with the number of device groups for each
  3. Displays the total count of device groups that will be updated
  4. Click Publish Changes to update all affected device groups
  5. 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.