Editor and Shortcode

This guide covers the block editor, classic editor, and shortcode usage.

Block Editor #

Stream Integration Pro registers a dedicated video block integration for Stream-backed attachments.

Common actions inside the block #

• choose a video from the WordPress Media Library
• upload a new video directly to Stream
• replace the current video

Poster controls #

The block supports three poster modes:

• Use global poster setting
• Thumbnail time (seconds)
• Custom poster image

Use global poster setting #

Uses the site-wide Poster time (seconds) setting from the plugin settings page.

Thumbnail time (seconds) #

Overrides the poster thumbnail time for this block only.

Custom poster image #

Lets you choose a custom image from the WordPress Media Library.

Classic Editor #

Stream Integration Pro adds a classic editor helper so you can insert a Stream video shortcode without writing it manually.

Typical result:

[sip_video id="123"]

Shortcode #

The main shortcode is:

[sip_video]

Most common usage #

Use a WordPress attachment ID:

[sip_video id="123"]

This is the recommended format.

Stream Integration Pro is designed around WordPress attachments as the source of truth. Using an attachment ID keeps the shortcode tied to the same Media Library item, so Stream sync, local restore, cleanup actions, and editor workflows all continue to point to one attachment record.

Use a Stream UID directly:

[sip_video uid="b05394e7700fb314818990c4d73ee58e"]

Use uid when you want a more manual or advanced embed flow, or when you need to reference a Stream video directly without relying on an existing WordPress attachment.

Supported Shortcode Attributes #

id #

WordPress attachment ID. This is the recommended and WordPress-native way to use the shortcode.

uid #

Cloudflare Stream UID. This is useful for manual embeds or compatibility workflows.

controls #

true or false

autoplay #

true or false

loop #

true or false

muted #

true or false

preload #

true or false

poster #

A custom poster image URL.

poster_time #

A poster thumbnail time in seconds.

Example Shortcodes #

Attachment-based playback #

[sip_video id="123"]

Attachment with custom poster time #

[sip_video id="123" poster_time="8"]

Attachment with custom poster image #

[sip_video id="123" poster="https://example.com/uploads/poster.jpg"]

Stream UID with autoplay and muted playback #

[sip_video uid="b05394e7700fb314818990c4d73ee58e" autoplay="true" muted="true"]

Frontend Rendering #

Stream Integration Pro uses the same player wrapper logic for:

• block output
• shortcode output

This keeps the frontend player responsive and consistent with the editor preview.

Local Playback Fallback #

If a shortcode references an attachment without a Stream UID but the local WordPress file still exists, the plugin falls back to WordPress video playback.

That means the shortcode remains useful even if the attachment is currently local-only.