Skip to content

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.
Table of Contents

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.

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

Steps

  1. Add the Video block to your page and click Design from Scratch.
  1. Set Source to Vimeo.
The Source setting with YouTube, Vimeo and Self Hosted
  1. Paste the number into Vimeo ID.
The Vimeo ID field
  1. In Player Settings, switch Intro Title, Intro Portrait and Intro Byline off for a clean player.
The Player Settings panel
  1. Set Controls Color to match your design.
  1. Write an Iframe Title in the Accessibility panel.
The Iframe Title field

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

Share your Thoughts

Still in Doubt? Let’s Assist You

Have Feedback or Questions?

Join our WordPress Community on Facebook!

Related Frequently Asked Questions

What do I need before embedding a Vimeo video in WordPress?

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.

Why is my Vimeo embed showing the title, author, and portrait?

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.

Why is my Vimeo player blank in WordPress?

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.

Why does Vimeo say the video is private or cannot be played?

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.

Can I use autoplay with a Vimeo video embed?

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.

What is the best way to make a Vimeo embed match my page design?

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.

Last reviewed: September 28, 2026

Related Docs