Connect a Video Platform
MediaShield overviewFree + ProGet MediaShield →
PRO - requires MediaShield Pro. Without Pro you can still add a single video by pasting its URL.
Connect your Bunny Stream, YouTube, Vimeo or Wistia account so you can browse that library inside WordPress and import videos in bulk. MediaShield then wraps each imported video in the protected player (watermark, login gate, tracking).
Why use it
Section titled “Why use it”You pick videos from your library inside WordPress instead of copying and pasting an address for each one, and every imported video is wrapped in the protected player straight away. For a catalogue of dozens or hundreds of lessons that saves hours and avoids typing mistakes.
Before you start
Section titled “Before you start”- Free MediaShield and MediaShield Pro are both active.
- You have API details from the platform (see each platform below).
- For Bunny Stream you also know your Pull Zone Hostname (the address your videos stream from).
What you can do with each platform
Section titled “What you can do with each platform”| Platform | Browse and import | Filter in the browser | Upload from WordPress |
|---|---|---|---|
| Bunny Stream | Yes | Collection | Yes, see Upload Queue and Default Upload Target |
| YouTube | Yes | Playlist | Yes |
| Vimeo | Yes | Folder | Yes |
| Wistia | Yes | Project | Yes |
No platform is hosted by MediaShield. Your videos stay on the platform and stream from its servers. MediaShield only wraps the player. Encryption, if any, is done by the platform. See Encryption and DRM.
Connect a platform
Section titled “Connect a platform”- Go to MediaShield > Platforms.
- In Connect a Platform, choose the platform.
- Type a Connection Name so you can tell connections apart (for example “Course Videos”). This is optional.
- Fill in the fields for that platform (tables below).
- Click Connect Platform. A “Platform connected.” message appears and the connection is listed with a Connected badge.
Bunny Stream
Section titled “Bunny Stream”| Field | Required | What it is | Where to find it |
|---|---|---|---|
| API Key | Yes | The Stream API key for this library. It lets MediaShield read and upload to it. Do not use the account key from Account > API Keys, which grants full account access | Bunny dashboard > Stream > your library > API |
| Library ID | Yes | Identifies your Stream library | Stream > Library settings |
| Pull Zone Hostname | Yes | Where videos stream from, for example vz-12345-e25.b-cdn.net. You can type only the prefix and .b-cdn.net is added. A pasted https:// and a trailing slash are removed |
Stream > Library > Hostname |
| CDN Token Key | No | Needed only if your library uses token authentication, so thumbnails and URLs can be signed | Stream > Security > Token Authentication Key |
MediaShield checks the API key and Library ID with Bunny before it saves anything. If Bunny refuses them you see “Bunny Stream validation failed” with Bunny’s reason, and nothing is stored. The connection is also refused without a Pull Zone Hostname, so you never end up with a connection that imports videos that cannot play.
After connecting, copy the Webhook URL shown on the Platforms page into Bunny. See Bunny Webhook.
YouTube
Section titled “YouTube”| Field | Required | What it is | Where to find it |
|---|---|---|---|
| API Key | Yes | A YouTube Data API v3 key | Google Cloud Console > APIs > YouTube Data API v3 > Credentials |
| Channel ID | Needed to list videos | The channel whose videos you browse. Starts with UC. The form lets you connect without it, but the library then has nothing to list |
YouTube Studio > Settings > Channel > Advanced settings |
| Field | Required | What it is | Where to find it |
|---|---|---|---|
| API Key / Access Token | Yes | A personal access token with the scopes public, private and video_files | developer.vimeo.com > My Apps > Generate Access Token |
| Client Secret | No | Not needed for browsing and importing | Your Vimeo app |
Wistia
Section titled “Wistia”| Field | Required | What it is | Where to find it |
|---|---|---|---|
| API Key / Access Token | Yes | A Wistia API token with all permissions | Wistia > Account > API Access |
| Project ID | No | Optional | Wistia project |
MediaShield checks credentials against the platform only for Bunny Stream. For YouTube, Vimeo and Wistia a wrong key is saved without complaint and you find out when you open the library browser.
Where your credentials go
Section titled “Where your credentials go”Your API key and secret are encrypted (AES-256-CBC) before they are saved, using a key derived from your site’s SECURE_AUTH_SALT. The Platforms screen never shows them again.
- If you regenerate your WordPress salts, saved credentials become unreadable. Disconnect and connect again.
- The Bunny “Token authentication key” on the Bunny Playback page is stored separately and is encrypted. See Play Bunny Videos in the MediaShield Player.
Browse and import videos
Section titled “Browse and import videos”- On MediaShield > Platforms, click Browse & Import on a connected platform. The library opens as a grid or a list (switch with the Grid view and List view buttons).
- Use Search videos, and the filter at the top (Collection, Playlist, Folder or Project, depending on the platform), to narrow the list.
- Tick the videos you want. Clear Selection unticks all.
- Click Import Selected (n).
- A message reports how many imported, how many were already imported and how many failed. Click Go to Videos to see them.
What import does for each video:
- Creates a published MediaShield video with the platform title.
- Saves the platform, the platform video ID, the stream or embed address and the duration.
- For Bunny, Vimeo and Wistia, downloads the platform thumbnail and sets it as the featured image. YouTube imports do not set a featured image.
- For Bunny, also saves the library ID.
- Skips any video you already imported, so running it twice is safe.
Page sizes: Bunny, Vimeo and Wistia lists load up to 100 videos per page, YouTube up to 50. Use Next page and Previous page to move through large libraries. Refresh reloads from the platform.
Imported videos get the site-wide default protection level. Open a video under Videos to change its protection level, role restriction or player options.
Disconnect a platform
Section titled “Disconnect a platform”- Go to MediaShield > Platforms.
- Click Disconnect on the connection.
Disconnecting deletes the saved credentials. Videos you already imported stay in your library, but you can no longer browse that library, and Bunny videos can no longer be signed through that connection until you connect again.
Connect more than one library
Section titled “Connect more than one library”You can connect several libraries on the same platform, for example two Bunny libraries for different courses. Each connection is stored separately. The Default Upload Target “Auto” setting uses the first active connection in alphabetical order of platform name.
What viewers see
Section titled “What viewers see”Nothing changes for viewers except that the video is wrapped in the protected player. Connecting an account is an admin task.
Settings and options for this feature
Section titled “Settings and options for this feature”| Where | Name | Default | What it does |
|---|---|---|---|
| Connection form | Connection Name | empty | Label shown on the card |
| Connection form | Pull Zone Hostname, CDN Token Key (Bunny) | empty | See the Bunny table |
| Connection form | Channel ID (YouTube) | empty | Channel to browse |
| Settings > Upload & Storage | Default Upload Target | Auto | Where new uploads go. See Upload Queue and Default Upload Target |
Next steps
Section titled “Next steps”- See every integration and its edition.
- Play Bunny videos through the MediaShield player so watermark and tracking work on them.
- Set up the Bunny webhook for encoding status.
- Link a video to a lesson.
If something does not work, see Troubleshooting.

