--- title: "How to Embed a Vimeo Video in WordPress?" url: https://nexterwp.com/docs/embed-a-vimeo-video-in-wordpress/ date: 2024-12-11 modified: 2026-09-28 lang: en author: "Aditya Sharma" description: "Vimeo's player carries its own intro — the title, the author and their portrait — before your video starts. The Video block embeds it with each of those under your..." image: https://nexterwp.com/wp-content/uploads/2024/12/How-to-Embed-a-Vimeo-Video-in-WordPress_-1024x519.jpg word_count: 413 --- # How to Embed a Vimeo Video in WordPress? ## Key Takeaways - Nexter Blocks Video block embeds Vimeo with the video ID, not the URL, and it is available in the free Nexter Blocks plugin under Nexter > Blocks. - Player Settings let the Video block switch Intro Title, Intro Portrait, and Intro Byline off, set Controls Color, and add an Iframe Title for screen readers. - Vimeo privacy settings still apply, one video per block is supported, and a blank player usually means only the number from the end of the Vimeo URL is used. Vimeo's player carries its own intro — the title, the author and their portrait — before your video starts. The Video block embeds it with each of those under your control. *For every Video setting in one place, see the [Video block guide](https://nexterwp.com/docs/add-videos-in-wordpress/).* [LIVE BLOCK LINK](https://nexterwp.com/nexter-blocks/blocks/wordpress-video-player/) ## Before You Start - **Edition:** **Free** — the Video block is in the free Nexter Blocks plugin.- **Block to enable:** Video, switched on under **Nexter > Blocks** in your WordPress dashboard.- **The video id** — the number at the end of the Vimeo URL. ![A real Vimeo video embedded with the Video block](https://nexterwp.com/wp-content/uploads/2026/09/video-vimeo-embed-fe.webp) ## Steps - Add the **Video** block to your page and click **Design from Scratch**. - Set **Source** to **Vimeo**. ![The Source setting with YouTube, Vimeo and Self Hosted](https://nexterwp.com/wp-content/uploads/2026/09/video-source.webp) - Paste the number into **Vimeo ID**. ![The Vimeo ID field](https://nexterwp.com/wp-content/uploads/2026/09/video-vimeo.webp) - In **Player Settings**, switch **Intro Title**, **Intro Portrait** and **Intro Byline** off for a clean player. ![The Player Settings panel](https://nexterwp.com/wp-content/uploads/2026/09/video-player.webp) - Set **Controls Color** to match your design. - Write an **Iframe Title** in the Accessibility panel. ![The Iframe Title field](https://nexterwp.com/wp-content/uploads/2026/09/video-a11y.webp) > ***Iframe Title**, in the Accessibility panel, names the player for screen readers. Left blank it renders as My Video* on every video on the site — confirmed on the front end — so it is worth setting. ## How It Behaves - The block renders a `player.vimeo.com` embed with your intro choices as URL parameters — confirmed on the front end.- **Controls Color** tints Vimeo's own player controls, which is the main way to make the player feel like part of your page.- **Autoplay, Mute and Loop** work as they do for YouTube, with the same browser rule that autoplay needs mute.- **Custom Layout** works here too, replacing the player with your own thumbnail until someone clicks. ## Limitations - **It takes the id, not the URL.**- **The embed URL the block builds is malformed.** Measured, the intro parameters appear twice with opposite values and stray semicolons — for example `&title=0&byline=0&portrait=0&&title=1;&portrait=1;&byline=1;`. Vimeo reads the last value so the toggles do work, but the URL is wrong and may not stay reliable.- Vimeo's own privacy settings still apply. A video restricted to certain domains will not play here unless your domain is allowed.- One video per block. For a row of videos, use several blocks or a carousel. ## Troubleshooting ### The player is blank Use only the number from the end of the Vimeo URL. ### It says the video is private or cannot be played That is Vimeo's own setting. Allow your domain in the video's privacy settings on Vimeo. ### The intro still shows Switch **Intro Title**, **Intro Portrait** and **Intro Byline** off. Some Vimeo plans force parts of the intro regardless. ## Related Docs - [Video block: all settings](https://nexterwp.com/docs/add-videos-in-wordpress/)- [Embed a YouTube video](https://nexterwp.com/docs/embed-a-youtube-video-in-wordpress/)- [Add a self-hosted video](https://nexterwp.com/docs/add-a-self-hosted-video-in-wordpress/) ## Frequently Asked Questions **Q: What do I need before embedding a Vimeo video in WordPress?** A: The setup is simple, but the key detail is that the block wants the Vimeo video ID, not the full URL. In Nexter Blocks, the Video block is available in the free plugin, and you enable it under Nexter > Blocks in your WordPress dashboard. That matters because the tutorial depends on the Video block being switched on before you start. The Vimeo ID is just the number at the end of the Vimeo URL. **Q: Why is my Vimeo embed showing the title, author, and portrait?** A: Vimeo’s player adds its own intro with the title, author, and portrait before playback starts. In Nexter Blocks, those pieces are controlled in Player Settings with Intro Title, Intro Portrait, and Intro Byline. Turning them off gives you a cleaner player that feels more like part of your page instead of a branded Vimeo card. The page also notes that some Vimeo plans can still force parts of the intro. **Q: Why is my Vimeo player blank in WordPress?** A: A blank player usually means the wrong value was pasted into Vimeo ID. The Video block needs only the number from the end of the Vimeo URL, not the full link. That distinction matters because the embed is built from that ID, so extra URL text breaks it. If you want a quick sanity check, compare what you pasted against the last number in the Vimeo link. **Q: Why does Vimeo say the video is private or cannot be played?** A: That message comes from Vimeo’s own privacy settings, not from Nexter Blocks. A video restricted to certain domains will only play if your domain is allowed in Vimeo’s privacy settings. This is a common gotcha when an embed works in one place but fails on another site. The fix lives on Vimeo’s side because domain access controls are enforced there. **Q: Can I use autoplay with a Vimeo video embed?** A: Autoplay works here the same way it does for YouTube, including the browser rule that autoplay needs mute. That means autoplay is not just a toggle choice, it depends on browser behavior as well. If you want a video to start automatically without getting blocked, mute has to be part of the setup. Nexter Blocks applies this through its Video block settings. **Q: What is the best way to make a Vimeo embed match my page design?** A: Controls Color is the main styling lever for making Vimeo feel native to your page because it tints Vimeo’s own player controls. Nexter Blocks also supports Custom Layout, which can replace the player with your own thumbnail until someone clicks. For a cleaner look, turn off Intro Title, Intro Portrait, and Intro Byline too. That combination gives you more control over both branding and first impression.