Key takeaways
- A plain Streamable link (streamable.com/abc123) opens the video page; the embed link (streamable.com/e/abc123) is the player on its own, built to go inside an iframe.
- Wrap the iframe in a container with a fixed aspect ratio so it scales on phones instead of overflowing.
- Always give the iframe a descriptive title and surround it with real text. Search engines and screen readers cannot read the inside of a video.
- If an embed shows blank, check domain privacy, the video's privacy level and your page's Content Security Policy.
Sharing a short clip is easy; making it work well on a web page takes a few more details. This guide covers the difference between the link types, a clean responsive embed, what to check when the player does not appear, and how to write the content around a video so it is useful to readers and to search engines.
Link or embed: which should you use?
| Method | What it looks like | Use it for |
|---|---|---|
| Watch link | https://streamable.com/abc123 | Messages, email, chat, social posts, tickets |
| Embed link | https://streamable.com/e/abc123 | The src of an iframe on your own page |
| Direct MP4 file | A file on your device or your own server | Archiving, editing, or hosting the video yourself |
A watch link is the right answer for most people: paste it where you want people to see the clip. Many chat apps and social platforms turn the link into a playable preview on their own. Embedding is for when the clip should play inside your own page without sending the reader away.
A clean, responsive iframe
The simplest embed is an iframe pointing at the embed link:
<iframe src="https://streamable.com/e/abc123"
width="640" height="360"
title="Short description of what the video shows"
allowfullscreen
loading="lazy"></iframe>That works, but the fixed width will overflow narrow phone screens. The robust pattern is to wrap the iframe in a container that holds the aspect ratio and let the iframe fill it:
<div class="video-wrap">
<iframe src="https://streamable.com/e/abc123"
title="Short description of what the video shows"
allowfullscreen loading="lazy"></iframe>
</div>
<style>
.video-wrap { position: relative; width: 100%; aspect-ratio: 16 / 9; }
.video-wrap iframe { position: absolute; inset: 0; width: 100%; height: 100%; border: 0; }
</style>Replace abc123 with your video's short code. Streamable's own share dialog also generates embed code for each video, which is worth copying if you want the player's current default options.
Pick the right aspect ratio
Most clips are 16:9 (landscape). Phone recordings are often 9:16 (portrait), and some are square. Using the wrong ratio leaves black bars or crops the picture. Check the video's real dimensions with the steps in how to check a video's resolution, bitrate and codec, then set aspect-ratio to match (for example 9 / 16) and limit the width with max-width so a portrait video does not fill the whole screen.
Write around the video, not just the video
A page that is only an iframe has very little for readers or search engines to work with. The text on the page is what tells people what the clip is and why it matters. A few habits make an embedded video page more useful:
- Add a one- or two-sentence summary directly above the video saying what it shows and how long it is.
- Add a transcript or key moments below it, especially for tutorials. This also helps readers who cannot play audio.
- Use a meaningful iframe title. Screen readers announce it. "Streamable video" is useless; "Demo of the checkout error on Safari" is helpful.
- Do not autoplay with sound. It is irritating and most browsers block it anyway.
- Lazy-load below-the-fold videos with loading="lazy", so an embedded player does not slow down the first view of the page.
When an embed does not show
If you see an empty box or a broken-player icon, go through this list:
- Is the video still online? Open the watch link directly. Expired and deleted videos leave blank embeds. See how long Streamable videos last.
- Is it private? Embeds of Only Me videos will not play for visitors, and password-protected videos prompt for a password. See Streamable privacy settings explained.
- Is Domain Privacy on? Streamable's account settings let you restrict embedding to listed domains. If your page's domain is not on the list, the player will not load there. Add the domain (and the www variant if you use it) in your account's privacy and security settings.
- Does your site's Content Security Policy allow it? If your site sends a CSP header, it needs to permit framing Streamable. For example, frame-src https://streamable.com. The browser's developer console will print a clear "Refused to frame" message if this is the problem.
- Are you mixing HTTP and HTTPS? A secure page cannot embed an insecure frame. Always use the https:// version of the embed link.
- Is a blocker interfering? Test in a private window with extensions off. More playback troubleshooting is in Streamable video not playing? Nine fixes.
Sharing in chats and social posts
For messaging apps and social platforms, paste the watch link on its own line. Many apps expand the link into a preview card or an inline player, but behaviour differs from app to app and changes over time, so do not assume a particular result. If the app does not show a preview, the recipient can still tap the link. If the clip must be seen inside the app, upload the video file directly there instead, taking care with that app's size and length limits (see how to compress a video to fit a size limit).
Think about what happens if the link disappears
An embed depends on someone else's server staying up and keeping your video. For a page that needs to last, such as documentation, a tutorial or a portfolio, keep a copy of the original file and decide in advance where the video would move if Streamable stopped working for you. Choosing a video host for short clips walks through the questions to ask.
Quick answers
What is the difference between /e/ and a normal Streamable link?
The normal link opens the full video page. The /e/ link opens only the player, which is what you want inside an iframe.
Can I embed a Streamable video on any website?
Usually yes, unless the video owner has turned on Domain Privacy and your domain is not listed, or the video is private. Your own site must also allow framing Streamable in its Content Security Policy if it uses one.
Do embedded videos help SEO?
A video on its own does little. The surrounding text, a descriptive title and a transcript do the real work. A video that makes your page more useful can keep readers on it longer, but do not expect an embed to rank by itself.
Need to save a Streamable clip? Paste its link into the free Streamable downloader and get the original MP4 in a few seconds. Only download videos you own or have permission to keep: see our copyright basics guide.