How to add Mastodon Feed to a Publii plugin

Embed Mastodon Feed on Publii

01

Create a Mastodon Feed website for Publii on Common Ninja

First, create a Publii Mastodon Feed website on Common Ninja. On the websites catalog, find the Mastodon Feed and enter the Editor.

02

Save the Mastodon Feed website

When you're done creating the Mastodon Feed website, click on the Save Changes button at the right top corner of the editor. If you don't have an account on Common Ninja, you'll have to register first.

03

Copy the Mastodon Feed Embed Code

When you're ready to add the Mastodon Feed website to your Publii plugin, click the Add To Website button at the top bar of the Editor. On the window that opens, click the Copy Icon to copy the website embed code. In the next steps, you will paste this code into your Publii plugin.

04

Paste the code to your Publii website’s HTML field.

Next, go to your Publii plugin editor and find the HTML field. It is most likely in the form of an HTML/Code widget or module which you can find on the Publii’s editor. Add it to your page, and paste the Mastodon Feed Embed Code you’ve copied before to the HTML field. Save and update, and that’s it, you should have Common Ninja’s Mastodon Feed website on your Publii plugin.

05

Alternative Method 1: Through the HTML option in the text’s editing area.

If you can't find the HTML/Code widget or module, there's another way to put Common Ninja’s Mastodon Feed website on your Publii website. You can just add the code to a special HTML section in the text editor.

06

Alternative Method 2: Add it directly to your Publii plugin’s HTML code.

If you're having trouble finding a widget or a special part in your text editor where you can add the Embed Code, you can try a different way to add the Mastodon Feed website to your Publii plugin. You can do this by putting it straight into your Publii plugin's HTML code.

Why Use This Widget

Use the Mastodon Feed widget when your brand is active on Mastodon and you want that activity visible on your site. A live feed brings your latest posts into a structured, readable section that updates automatically. This helps visitors discover your voice, announcements, and community interactions without leaving your domain. It is valuable for creators, open source projects, media brands, and organizations with decentralized audiences. Auto updates keep the site feeling current with minimal effort, and short post previews are easy to scan. Embedding the feed also encourages new followers by showing the value of your Mastodon presence directly to website visitors, strengthening consistency across your channels.

This tutorial was written by the Common Ninja product team, creators of interactive, no-code widgets for Publii plugin. Common Ninja helps over 500,000 users build engaging online experiences without coding.