Vimeo Embed

In this article

Go back to the list of Blocks

Vimeo is a popular video-sharing service. With the Vimeo block, you can embed videos from Vimeo into your WordPress website. You don’t need a Vimeo account to be able to use it. You can only embed all public Vimeo videos.

When embedded, a Vimeo video would look like this inside your WordPress post or page.

Embedded Vimeo Video:

Vimeo Embed example

Steps to Embed a Vimeo Video:

1. Find the URL of the Vimeo video

Find your video on, and copy the URL of the video from the browser bar.

How to get the vimeo video URL

2. Add a Vimeo Embed block to your post

How to quickly add a vimeo block

Detailed instructions on adding blocks

3. Paste the Vimeo URL from Step 1

Paste the video link into the text box.

4. Click the Embed button

If it’s a link that can be successfully embedded you will see a preview in your editor.

Preview of the vimeo  Block

If you use a URL that can’t be embedded, the block shows the message “Sorry, this content could not be embedded.” 

Error message when you cannot embed a URL in the SoundCloud block

You will have two choices: Try again with a different URL or convert to link.

5. You’ll see the Vimeo player on your WordPress editor if you successfully embed a Vimeo video

Preview in the Vimeo video

Block Toolbar

Besides the Mover and Drag & Drop Handle, the Block Toolbar for Vimeo embed shows four buttons:

  • Transform to
  • Change alignment
  • Edit URL, and
  • More Options
Block toolbar in the vimeo video block

Transform to

Transform option in the vimeo block

You can transform a Vimeo embed block into a Group. This would give you the ability to change the background color around the Vimeo embed.

Vimeo block inside the group block
Editor view of a Vimeo embed as a group with Color Settings controls
Vimeo embed with a gray background-color
Vimeo embed with a gray background-color

Change Alignment

Change alignment in the vimeo block
  • None – Default alignment option.
  • Wide width – Increase the width of the post beyond the content size.
  • Full width – Extend the block to cover the full width of the screen.
  • Align left – Make the block left-aligned.
  • Align center – Make the block alignment centered.
  • Align right – Make the block right aligned.


Edit URL

Via the Edit URL, you can change the Vimeo Embed URL in the embed block. Overwrite the existing URL and click on the Embed button.

Edit URL in the vimeo block

More options

These controls give you the option to copy, duplicate, and edit your block as HTML.

Read about these and other settings.

Block Settings

Block settings for the vimeo block

Besides the Advanced section, the Vimeo embed has only one setting in the “Block Settings” sidebar: Media Settings.

Media Settings

Media settings turned off in the vimeo block and Media settings turned on in the vimeo block

Via the Media Settings, you can control the behavior of your post embed when viewed from a smaller device, like on a phone screen.

The Toggle switch turns on or off the resize functionality for smaller devices. The default setting is “on” or blue.

“Off:” This embed may not preserve its aspect ratio when the browser is resized. In the off position, the toggle switch is gray.

“On:” This embed will preserve its aspect ratio when the browser is resized. The toggle switch turns blue in the “On” position.


The advanced section lets you add a CSS class to your block.

The advanced tab lets you add a CSS class to your block, allowing you to write custom CSS and style the block as you see fit. For a Vimeo embed there are default CSS classes to allow for responsive handling of the embed when viewed on smaller devices like mobile phones.


  • Updated 2022-11-25
    • Removed redundant content
    • Added alt text to images
    • Aligned images for mobile view
  • Created on 2022-03-01

Was this article helpful? How could it be improved?

First published

Last updated