Share on Mastodon


Automatically share WordPress posts on Mastodon.

You choose which Post Types are shared, though sharing can still be disabled on a per-post basis.

Supports image uploads, WordPress’s new block editor, and comes with a number of filter hooks for developers.

More details can be found on this plugin’s GitHub page.


Share icon by Heroicons, licensed under the terms of the MIT License. Elephant illustration sourced from Mastodon’s Press Kit.


Within WP Admin, visit Plugins > Add New and search for “share on mastodon” to locate the plugin. (Alternatively, upload this plugin’s ZIP file via the “Upload Plugin” button.)

After activation, head over to Settings > Share on Mastodon to authorize WordPress to post to your Mastodon account.

More detailed instructions can be found on this plugin’s GitHub page.


May 4, 2023
This plugin does exactly what it says it will. No complaints on it at all and the developer seems to be on top of fixing, and adding features. Keep up the good work!
April 29, 2023
This plugin has always worked amazing for me and also supports hooks that allow for additional customization. I would highly recommend it as my first choice for anyone looking for this functionality.
February 26, 2023 4 replies
The installation is very simple and the developer gives great support. It works fantastic.
January 8, 2023 1 reply
Very easy to install and setup, it simply posts the title of your post and its url to Mastodon. I would like to see a slight increase in customisability, so you could maybe add some default text and hashtags to that post (''New post from This Blog: [title][url] # # # ''). If thats not added I'll likely move away from this plugin to a more advanced one.
December 30, 2022 3 replies
UPDATE: This was user error, apparently you need to include the https:// too Unable to use this as it claims that '' is an invalid URL/instance.
October 31, 2022
This plugin does exactly what it promises to do: share my posts on Mastodon. Initial setup is very simple and it works right away in basic form. There is a lot of fine-tuning available and it's not difficult to get it working the way you like it. Just visit Jan Boddez's blog to get the details on how to do this. Tested with WordPress version 6.03.
Read all 6 reviews

Contributors & Developers

“Share on Mastodon” is open source software. The following people have contributed to this plugin.


“Share on Mastodon” has been translated into 2 locales. Thank you to the translators for their contributions.

Translate “Share on Mastodon” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



A very first implementation of optional custom status messages.


Improve Syndication Links compatibility.


Prevent accidental sharing of (very) old posts.


Custom field fix.


Filterable media array.


Configurable debug logging.


More flexible/robust instance URL handling. Overhauled plugin options. Syndication Links compatibility.


Avoid duplicate posts for CPTs without explicit custom field support.


Add (experimental) support for in-post images, and alt text fallback.


Additional share_on_mastodon_toot_args filter argument. Add stable tag.


Add as Micropub syndication target.


Include option to delay crossposting. Might be used to try to fix issues with slow image uploads and the like.


Exclude more default post types. Store Mastodon username in settings.


Prevent older WP versions from adding featured images twice.


Provide filter for “opt-in” sharing.


Slightly more robust Mastodon host URL handling.


Fix array notices.


Add URL information in meta box.


Avoid double-encoded HTML entities.


Support uploading of up to 4 attached images. Add additional arguments filter, e.g, for toot threading.


Fix Post_Handler actions.


Added token verification cron job.


Added ability to add image descriptions, improved debugging.


Allow Post_Handler hooks to be removed, too.


Fix transition_post_status parameter order.


Initial release.