Inline Playlist Switching

Introduction

One of playout.video's most powerful features is the ability to switch what's playing on your live stream without stopping or interrupting the broadcast. Inline playlist switching lets you temporarily play different content, then automatically return to your main playlist when the temporary content finishes.

This means your viewers get a clean transition with zero downtime, no buffering, and no reconnection on their end.

How Inline Switching Works

Think of it like a TV channel cutting to a special segment and then returning to regular programming:

Your main playlist is playing normally (looping your regular content)
You activate inline mode with a different playlist
The stream transitions to the inline playlist content without interruption
When the inline playlist finishes, the stream automatically returns to your main playlist
Your main playlist resumes exactly where it left off

The entire process is invisible to viewers. They see one continuous stream with different content appearing at different times.

When to Use Inline Switching

Scheduled Content Blocks

Play specific content at specific times without permanently changing your playlist:

Morning devotionals on a church stream, then back to sermons
News updates on a media channel, then back to regular programming
Special announcements on any channel, then back to normal content

Event Coverage

Temporarily switch to event-specific content:

Live event replays: switch to event footage, then return to regular content
Holiday specials: play Christmas or Halloween content for a few hours
Product launches: showcase new content temporarily

Content Testing

Try out new content without committing to a permanent playlist change:

Play a new video or series to gauge viewer response
Test different content types during specific time slots
Experiment with content order or themes

Ad Breaks or Sponsorships

Insert sponsored content or promotional material:

Play sponsor messages during peak hours
Insert promotional videos at scheduled intervals
Run campaign-specific content for a limited time

Set these to start After the current video so an ad plays between two videos instead of cutting into one. See Right Away or After the Current Video.

Setting Up Inline Switching

Manual Inline Switch

To switch playlists manually while your stream is running:

Open your live stream's management page
Go to the Playlist panel
Activate Inline Mode
Select the playlist you want to play temporarily
Under When it starts, choose Right away or After the current video
The stream transitions to the inline playlist
When the inline playlist finishes, your main playlist resumes automatically

You can also cancel inline mode at any time to immediately return to the main playlist.

Screenshot suggestion: Playlist panel showing inline mode activated, with the temporary playlist content and a "Return to Main Playlist" button.

Scheduled Inline Switch

Automate inline switches using the scheduling feature:

Go to Schedule in the sidebar
Click Add Schedule
Select Switch Playlist as the action type
Choose the playlist to switch to
Set the switch type to Inline
Under When it starts, choose Right away or After the current video
Set the timing (one-time or recurring with cron)
Save

The system will automatically activate inline mode at the scheduled time and return to the main playlist when the inline content finishes.

Right Away or After the Current Video

Every playlist switch, manual or scheduled, inline or permanent, can start in one of two ways:

Right away cuts into the video that is playing and starts the new playlist at once. After an inline switch, your main playlist picks the cut video up where it stopped.
After the current video lets the video that is playing finish first, then starts the new playlist. After an inline switch, your main playlist carries on with its next video.

A few things to know about After the current video:

It waits as long as the video takes. If the video playing has an hour left, the switch starts in an hour.
One permanent switch and one inline switch can wait at the same time. When the video ends, the new main playlist takes over and the inline plays first, on top of it.
If a recurring schedule fires again while an earlier switch of the same kind is still waiting, the newer one takes its place, so a long video is followed by one ad, not several.
While a switch is waiting, the Playlist panel says so. Click the X next to it to cancel what is waiting, and the stream carries on with its playlist.
If nothing is playing when the switch arrives, for example while the stream is recovering from a problem, it starts right away. The same goes for a video that stops because of a problem while the switch waits for it.
On a stopped stream there is no video to wait for, so the switch does exactly what Right away would.

Example: Daily Special Content Block

Set up a recurring inline switch for a daily content block:

Create a playlist called "Daily Special" with your special content
Schedule an inline switch to "Daily Special" at 0 12 * * * (noon every day)
The special content plays at noon, then the main playlist resumes

Inline vs. Permanent Switch

playout.video offers two types of playlist switches:

Inline Switch (Temporary)

Plays the new playlist temporarily
Automatically returns to the main playlist when done
Main playlist resumes where it left off
Best for: scheduled content blocks, events, testing

Permanent Switch

Replaces the main playlist entirely
Does not automatically revert
The new playlist becomes the main playlist
Best for: seasonal content changes, complete playlist refreshes

Choose the type that matches your intent when creating a scheduled switch.

Best Practices

Keep Inline Playlists Focused

Inline playlists work best when they're short and purposeful:

5-30 minutes of content is ideal for most inline switches
Very long inline playlists (hours) may confuse viewers who expect your regular content
If you need to play different content for extended periods, consider a permanent switch instead

Plan Your Transitions

Think about how the inline content flows with your main content:

Use jingles or transition videos at the start and end of inline playlists
Match the tone of inline content to your channel's overall vibe
Avoid jarring transitions (e.g., switching from calm music to loud action content)

Test Before Scheduling

Before setting up recurring inline switches:

Test the inline switch manually to make sure the content plays correctly
Verify the transition back to the main playlist is smooth
Check that all videos in the inline playlist are fully processed

Communicate with Viewers

If your inline content is significantly different from your regular programming:

Add a text overlay announcing the special content
Include a "Regular programming returns shortly" message
Use your stream description to mention scheduled content blocks

Combining with Other Features

Inline Switch + Destination Scheduling

Combine inline playlists with destination scheduling for platform-specific content:

At 6 PM: start TikTok destination + activate inline playlist with vertical content
At 10 PM: stop TikTok destination + inline playlist ends, main content resumes

Inline Switch + Overlays

Change overlays to match your inline content:

Use different text overlays during special content blocks
Update the "Now Playing" display to reflect the inline content
Add a "Special Feature" badge overlay during inline playback

Troubleshooting

Inline switch didn't activate at the scheduled time?

Check that the schedule is active and the cron expression is correct
Verify the inline playlist exists and has processed videos
Check the stream's event log for any errors

Main playlist didn't resume after inline content?

The main playlist resumes when the inline playlist finishes playing through once
If the inline playlist is set to loop, it will continue until you manually cancel inline mode
Check that inline mode (not permanent switch) was selected

The switch cut into a video?

A switch set to Right away starts at once, in the middle of whatever is playing
To have it wait for the video to finish, edit the schedule (or switch again) and choose After the current video

Transition is not smooth?

For the smoothest experience, keep videos in both playlists at similar energy levels
Use After the current video so the switch happens between two videos

Viewers are confused by the content change?

Add overlay text explaining the special content
Keep inline playlists short and clearly different from regular content
Mention scheduled content blocks in your stream description

Next Steps

Building and Managing Playlists: complete playlist management guide
Scheduling Streams and Automated Actions: automate inline switches
Using the Overlay and Composition Editor: customize overlays for inline content