How to embed Mastodon posts on a website or blog

You can embed posts from Mastodon on your own website, blog or other platform that lets you post HTML code. Here’s how to do it:

  1. Log in through your server’s website or the web app
  2. Go to the post you want to embed
  3. Click ⋯ at the bottom of the post, then select Embed
  4. Copy and paste the HTML code into your website’s page code

What does embedding mean?

Embedding means the post itself will be displayed on the website, and all the post’s interactive elements such as links, images, video, audio etc can be clicked on and will work. For example, news website The Verge embedded a post from Mastodon in this story ⧉.

How do I embed Mastodon posts on WordPress sites and blogs?

If you’re using the block editor in WordPress, don’t use WordPress’s “Embed” block. Instead, use WordPress’s “Custom HTML” block and paste Mastodon’s HTML embedding code there.

Alternatively, if you’re editing the page’s code you can paste the embedding code directly.

How is embedding different from posting a screenshot?

Embedding a post means the post itself is displayed, and any interactive elements such as links, video, audio or images can be clicked on. Screenshots are just pictures of a post and cannot be interacted with.

Some posts don’t have an “Embed” option. How do I embed them?

If a post has a restricted visibility, it cannot be embedded because the creator of the post doesn’t want it to be widely seen. You can only embed posts with a public visibility.

I embedded a post but it doesn’t look like a Mastodon post any more? It uses some other format?

The post you embedded may be from a different type of Fediverse server. Embedding shows the post in the format used on its own server rather than your server.

Timelines on Mastodon servers show posts from all across the Fediverse. Some of these posts are from other Mastodon servers, but some are from different kinds of servers. For the sake of making timelines easy to read, your Mastodon server will display all posts in the same Mastodon format, but that’s not necessarily how they appear on their own server. If you embed a post from a different kind of server, it will look different when you embed it.

↩ Back to the front page