Tumblr embed

In this article

Go back to the list of Blocks

With the Tumblr Embed block, you can embed several types of posts from the microblogging platform. 

The post needs to be public to embed. It cannot be a standalone image (with the URL name.tumblr.com/image). You can, however, embed image posts (with the URL name.tumblr.com/post/etc) and the rest of Tumblr’s post types including: Text, Quote, Link, Chat, Audio and Video.  

An Example: 

Screenshot of a Tumblr post

If you are looking to import your Tumblr posts into WordPress, there is a process in the Tools section of your Dashboard.

Steps to embed a Tumblr post

  1. You need to find the link to the post. The easiest way to do this is to click on the three dots in the lower-right corner of the post and select Permalink.
The correct URL to copy to use the embed block
  1. Copy the URL at the top of your browser. On a PC, press CTRL+A in the URL field and then CTRL+C to copy the URL. On a Mac, press ⌘+ A and then ⌘+C. 
  2. Go to your post or page.
  3. Add the Tumblr block.
Adding the Tumblr block to a page or post

Detailed instructions on adding blocks

  1. Paste the link in the text box and click the “Embed” button. 
Embed option for the Tumblr block to paste the URL.
  1. If the link can be embedded, you will see a preview in your editor.
Preview of the embedded Video Press video within the WordPress editor.

If you cannot use that URL, an error message will popup saying “Sorry, this content could not be embedded.”

Example of a URL that cannot be embedded. Two options are presented, try again or convert to link.

If this happens you can: Try again with a different URL or convert it to a link.

Block Toolbar

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

Block Toolbar with options available for the Tumblr Block.
  • Transform to
  • Change alignment
  • Edit URL, and
  • More Options. 

Transform to:

Options to transform the Tumblr block to Paragraph, Columns or Group.

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

Editor view of a Tumblr Embed as a group with Color Settings controls
Editor view of an Tumblr Embed as a group with Color Settings controls
Tumblr Embed with a green background.
Tumblr Embed with a green background.


Alignment options for the block: wide width, full width, align left, align center, and align right.
  • Align left – Make the Tumblr post left aligned
  • Align center – Make the Tumblr post alignment centered
  • Align right – Make the  Tumblr post align right
  • Wide width – Increase the width of the post beyond the content size
  • Full width – extend the Tumblr post to cover the full width of the screen.

“Wide width” and “Full width” alignment need to be enabled by the Theme of your site. 

Edit URL

Via the edit URL, you can change the Tumblr Embed URL in the embed block. Overwrite the existing URL and click on the “Embed” Button.

Editing the block URL via the "edit" option.

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

Media Settings

New in 5.6: Resize the Tumblr post for smaller devices. It will preserve its aspect ratio when resized. 

Media settings for the embed block with the toggle OFF for resizing on smaller devices.
Media settings for the embed block with the toggle ON for resizing on smaller devices.


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.

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


  • Updated 2022-11-25
    • Removed redundant content
    • Aligned images for mobile view
    • Added alt text to images
  • Updated 2020-11-26
    • Screenshots as per WordPress 5.6
    • Hide Block Settings changed to Hide More Settings
    • Edit as HTML and Add to Reusable blocks removed
    • Added Media Settings
  • Created 2020-11-25

Was this article helpful? How could it be improved?

First published

Last updated