to the tippy ↑

WordPress & Wistia

WordPress is a wonderful platform that you can use to create powerful websites, but it can sometimes strip out important parts of Wistia embed codes. Foruntately, there's an easy fix for that!

To use Wistia and WordPress together in harmony, check out the Wistia WordPress plugin.

Note

Wistia embed codes can only be used with WordPress.org installs. Read up on the difference between WordPress.com hosted blogs and WordPress.org installs.

The Wistia WordPress Plugin

With the Wistia WordPress Plugin installed, you can add your embed codes to posts and they will be protected by the mighty anti-mangler. It won't take up any space in your WordPress admin dashboard, but instead works quietly in the background as a silent guardian.

The Wistia WordPress plugin also adds support for Wistia oEmbed URLs to WordPress. For more information about how that works, see this guide from the WordPress documentation: Embeds in WordPress.

Tip

If you'd love to see Wistia included as an oEmbed provider in WordPress by default, please let our friends at WordPress know!

Using an oEmbed URL

An oEmbed URL is a simple link that tells WordPress how to embed content from third-party sources (like that cool video hosting platform for businesses you're so fond of).

To create an oEmbed URL for a video in your Wistia account, select the "Use oEmbed" option under Advanced Options on the Embed & Share screen. Take a look-see:

That'll give you an oEmbed URL like this example:

http://dave.wistia.com/medias/azmurdmroz?embedType=api&videoWidth=640.

If you copy and paste that URL into a WordPress post and you have the Wistia WordPress plugin installed, WordPress will convert the oEmbed URL into an embedded video.

Note

If your account uses a custom domain name, this will not work. You'll need to use a wistia.com subdomain like "myawesomecompany.wistia.com" for your account URL instead.

If you're curious about the technical details behind oEmbed's sneaky magic, check out oEmbed.com.

Tips for Using WordPress

oEmbed URL not converting into an embedded video?

When inserting an oEmbed URL, make sure you are in HTML editing mode, and leave a line open above and below the URL. If you switch from HTML to Visual mode it can add formatting tags around your oEmbed URL, which may cause it to break. Be careful of that!

Video appearing smaller than it should be?

If you have larger resolution videos and they are appearing smaller or squished, access the WordPress admin control panel (Settings -> Media -> Maximum Video Embed Size) and set the max to the largest size of your video ('no limit' setting doesn't work, must be actual size). Some WordPress themes will also set a maximum width for content embedded with oEmbed. If you want to change that, check out How to Set oEmbed Max Width in WordPress 3.5 with $content_width.

Video not centered?

If you want to center your video inside a div or column on your website, and you are using an oEmbed URL to embed your video, please use a second div with the style display: inline-block;, as seen here:

center-wordpress.html
1
2
3
4
5
6
7
<div style="text-align: center;">
  <div style="display: inline-block;">

    http://dave.wistia.com/medias/mgdmzrzrm4?embedType=api&videoWidth=640

  </div>
</div>

For more info on centering your video, refer to our tips in the embedding documentation.

Using Wistia Video SEO Embeds with WordPress

The simplest way to help search engines find and index the Wistia videos on your WordPress.org site is to use the SEO embed code type and the awesome Yoast plugin. Joost, the one-man wrecking crew behind Yoast, has put together a really valuable and easy-to-use workflow that also includes Wistia support (awesome!). When you're using Yoast, you do not need to create a video sitemap in Wistia – Yoast does that for you.