Skip to content

Help playlist

Brent Cordis edited this page Aug 19, 2026 · 1 revision

Playlist (Edit)

Description

Settings for one playlist: which remote playlist it follows, whether Proclaim syncs it, and what the messages created by a sync should look like.

How to Access

Components → Proclaim → Playlists, then select a title, or select New.

Screenshot

The Playlist edit form

What You Can Do Here

I want to… Go to
Point this record at a YouTube playlist Choose the playlist to follow
Decide what synced messages look like Set the sync defaults
Let Proclaim change my YouTube playlist Allow changes to be pushed back
Look up a single field Screen Reference

Choose the playlist to follow

  1. Set Server to the YouTube server that holds the playlist. Only servers that support playlists appear in this list.
  2. Select Browse Playlists next to YouTube Playlist ID, and pick from the playlists on that channel.
  3. If you would rather type it, the ID is the part of a YouTube playlist URL after list=.
  4. Optionally set Linked Series so synced videos are filed into a series.

Set the sync defaults

Everything under Sync Defaults is applied to messages that a sync creates. It has no effect on messages you create yourself.

  1. Default Status — the status new messages get. Choose Unpublished if you want to review each one first.
  2. Default Teacher — who new messages are attributed to.
  3. Default Description — text placed on each new message.

Tip

These are starting values, not permanent ones. Editing a message afterwards changes only that message.

Allow changes to be pushed back

Push Changes to YouTube is off by default, and most sites should leave it off.

Warning

With it on, this playlist's title and description in Proclaim become the authoritative ones, and — if a Linked Series is set — videos in that series are added to the playlist on YouTube. Your real YouTube playlist changes.

Always use Preview Push on the Playlists list before a real push.

Screen Reference

Fields
Field What it is for
Status Published, Unpublished, Archived or Trashed
Title The display name for this playlist
Alias URL-friendly version of the title
Description An optional description of the playlist
Server The media server that hosts this playlist
YouTube Playlist ID The remote playlist ID — the value after list= in a YouTube playlist URL
Linked Series Synced videos are added to this series
Scheduled Sync When enabled, the scheduled task syncs new videos from this playlist
Push Changes to YouTube When enabled, your changes here are pushed back to the platform
Last Synced When this playlist last synced. Read-only
Default Status Publish status applied to messages created during a sync
Default Teacher Teacher assigned to messages created during a sync
Default Description Description applied to messages created during a sync
Access Joomla view level for this record
Language Language assignment
Toolbar
Button What it does
Save Saves and stays here
Save & Close Saves and returns to the list
Save & New Saves and opens a blank form
Cancel Discards changes
Help Opens this page

Quick Tips

  • Last Synced showing Never on a playlist with sync enabled just means the scheduled task has not run yet.
  • A playlist does not need a linked series. Without one, synced messages are created without a series.
  • Deleting a playlist here does not delete anything on YouTube.

If Something Goes Wrong

What you see What it usually means
This server type does not support playlists The selected server is not one that has playlists. Choose a YouTube server
Select a server first, then browse its playlists Set Server before selecting Browse Playlists
No playlists found on this server's channel The channel has no playlists, or the server's credentials cannot see them

Related Information

Clone this wiki locally