How to add Mastodon Feed to a XenForo community

Embed Mastodon Feed on XenForo

01

Create a Mastodon Feed plugin for XenForo on Common Ninja

First, create a XenForo Mastodon Feed plugin on Common Ninja. On the plugins catalog, find the Mastodon Feed and enter the Editor.

02

Save the Mastodon Feed plugin

When you're done creating the Mastodon Feed plugin, 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 plugin to your XenForo community, 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 plugin embed code. In the next steps, you will paste this code into your XenForo community.

04

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

Next, go to your XenForo community 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 XenForo’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 plugin on your XenForo community.

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 plugin on your XenForo plugin. You can just add the code to a special HTML section in the text editor.

06

Alternative Method 2: Add it directly to your XenForo community’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 plugin to your XenForo community. You can do this by putting it straight into your XenForo community'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 XenForo community. Common Ninja helps over 500,000 users build engaging online experiences without coding.