Inline embeds place a media player directly where you want it on your page. The tried-and-true style of embedding, inline videos can be watched at the embedded size or opened in full screen.
Inline is the best option for making videos prominent and visible on your pages, which is ideal for accessibility and video SEO. Wistia's inline embeds also offer the most flexibility in embed types, customizations, and options.
Where to find inline embed options
Click "Embed" on your media page and select the "Inline" tab. Sizing options (Responsive or Fixed size) are at the top. Click "Advanced Options" to choose Standard or Fallback, or to turn on legacy embed code, oEmbed URL, or SEO metadata. Wistia remembers your choices as your personal embed preferences.
Inline embed types
The inline embed comes in two versions:
Standard
Fallback (iframe)
The players look identical, though they may differ technically depending on your setup. We recommend trying the Standard embed first, but the Fallback can help if you have trouble embedding the Standard on your page.
Tip
Always copy your embed code from the Embed menu. Share links (URLs containing /s/), the media page URL shown in your browser bar, and /manage URLs are not embed codes and may cause display issues if pasted into your site builder.
Standard embed
The Standard is Wistia’s most modern embed type, utilizing JavaScript to render the video player directly on your page.
Standard embeds offer some technical benefits over traditional iframe embeds, such as faster time-to-ready and avoiding iframe-specific issues that can interfere with certain features.
Example: Inline (Standard) embed, fixed size
<script src="https://fast.wistia.com/player.js" async></script><script src="https://fast.wistia.com/embed/gmwg9g412y.js" async type="module"></script><style>wistia-player[media-id='gmwg9g412y']:not(:defined) { background: center / contain no-repeat url('https://fast.wistia.com/embed/medias/gmwg9g412y/swatch'); display: block; filter: blur(5px); }</style> <wistia-player media-id="gmwg9g412y" aspect="1.7777777777777777" style="width: 320px;height: 180px;"></wistia-player>
Example: Inline (Standard) embed, responsive sizing
<script src="https://fast.wistia.com/player.js" async></script><script src="https://fast.wistia.com/embed/gmwg9g412y.js" async type="module"></script><style>wistia-player[media-id='gmwg9g412y']:not(:defined) { background: center / contain no-repeat url('https://fast.wistia.com/embed/medias/gmwg9g412y/swatch'); display: block; filter: blur(5px); padding-top:56.25%; }</style> <wistia-player media-id="gmwg9g412y" aspect="1.7777777777777777"></wistia-player>
Fallback (iframe)
The Fallback is an iframe embed, a more classic way of embedding. The name "fallback" reflects its reliability where more modern embed codes aren't supported.
An iframe, or inline frame, allows you to embed one webpage within another, displaying content from a different source directly on your page. So, instead of embedding the media player directly on your page via JavaScript, it loads on a separate page and then displays in the iframe, which can make it load a bit slower. To the viewer, it will look identical to a Standard embed.
Tip
The iframe approach has been around a long time, so if your CMS or site builder doesn’t play nicely with the more modern Standard embed, try the Fallback instead.
Example: Inline (fallback) embed, fixed size
<iframe src="https://fast.wistia.net/embed/iframe/gmwg9g412y?web_component=true&seo=true&videoFoam=false" title="Wistia Standard Embed Example Video" allow="autoplay; fullscreen" allowtransparency="true" frameborder="0" scrolling="no" class="wistia_embed" name="wistia_embed" width="320px" height="180px"></iframe>
<script src="https://fast.wistia.net/player.js" async></script>
Inline embed sizing
Inline embeds can be set to a fixed size or resize responsively to fit any container.
Fixed size
Specify exact dimensions for your embed with Fixed Size. The media player will always display at this size, giving you precise control over how it appears on your page.
Responsive
As the most flexible sizing option, responsive embeds will resize dynamically to fit the container, browser window, or screen.
Responsive sizing ensures your content looks great on all screen sizes, from desktop monitors to mobile phones, and most modern websites and site templates are designed responsively.
No need to worry about the dimensions; just select responsive sizing, copy the embed code, and paste it into your page. You can control or restrict the player's size by adjusting the width of its parent container, but avoid modifying the embed code or player CSS directly outside of our supported embed options.
Tip
The Wistia player is width-responsive and adjusts based on changes to the width of its parent container or page.
Advanced embed options
Use legacy embed code
Legacy embed codes will render our Vulcan player (also known as E-v1) on your page instead of our latest player, Aurora. Legacy embeds are slower, but may be a better fit if you’ve written custom code or have unique integration needs that expect our legacy embed code format.
Use oEmbed URL
oEmbed is a popular format that simplifies embedding by using URLs instead of HTML code.
Note
Only paste an oEmbed URL into a field that specifically supports oEmbed. Don't use it as the src of an iframe. That embeds the whole webpage rather than just the player.
See: Wistia and oEmbeds
Inject SEO metadata
With this option, the media player injects SEO metadata on your webpage as soon as it loads, helping your content get indexed in video search results. Optimize your media metadata in Wistia by editing the title, adding a detailed description, selecting a thumbnail, and adding a transcript.
Unchecking "Inject SEO metadata" only changes the embed code shown in the Embed menu and does not update embeds already on your page. To turn SEO metadata off for an existing embed, copy the new code and replace the embed on your page.
LLM-friendly embed
Looking to make your video's transcript readable by AI tools like ChatGPT and Perplexity? LLM-Friendly is a separate embed style. Select LLM-Friendly at the top of the Embed menu, rather than Inline. LLM-friendly embeds are available as inline embeds only.
Troubleshooting
Having trouble with embed sizing or other issues? See our Embed Troubleshooting guide for help with common issues.