WordPress plugin

The plugin needs WordPress 6.5 or later and PHP 8.1 or later.

Connect your site

1. Install and activate the Pellio plugin.
2. Go to Settings → Pellio and click Connect to Pellio.
3. Sign in if asked, check the workspace and click Connect site.

Your site’s domain is added to the workspace’s allowed domains, and the site appears in Settings → General → Connected WordPress sites, where you can disconnect it.

Adding videos

• Block editor: add a Pellio video block, then drop in one or more files, or choose from your library. Files upload straight from the browser to Pellio, not through your server, and large uploads resume if interrupted.
• Classic editor: click Add Pellio video above the editor.
• Shortcode: [pellio id="VIDEO_ID"], with optional autoplay="1", muted="1", loop="1", captions="1" and start="90".

Pages show a lightweight poster until someone presses play, and each embed includes VideoObject structured data for search engines.

Private videos

Embeds from a connected site are signed for each page view, so Private and domain-restricted videos play on your site and nowhere else. Logged-in users are recorded as viewers in your analytics. In Settings → Pellio you can also choose to pass logged-in users’ email addresses to Pellio so they’re named in analytics and skip email forms.

Migrating embeds

Tools → Pellio scans your site for Vimeo, Wistia and YouTube embeds and shows which ones are already in your Pellio library (import them first; see Importing videos). Replace them in one click; each run is backed up and can be undone. The same screen can offload videos from your Media Library to Pellio.

WP-CLI

wp pellio status
wp pellio scan
wp pellio migrate --dry-run
wp pellio migrate
wp pellio rollback [run-id]
wp pellio offload --replace