Post to Mastodon with Jetpack Social

Automatically publish your blog posts on your Mastodon profile with the Jetpack Social auto-sharing feature. 

Connect your site to your Mastodon profile

To connect your Mastodon social media profile to your website, follow the steps below:

1. Log in to your Mastodon account.
2. From your site’s WP Admin, go to Jetpack → Social.
3. If the Jetpack Social sharing feature is turned off, turn on the Automatically share your posts to social networks toggle to enable it.
4. Click on the Connect an Account button.
5. Find the Mastodon logo on the “Manage Jetpack Social connections” window and click the Connect button adjacent to it. A field will open below for you to input your Mastodon username in this format: @yourmastodonusername@mastodon.social.
6. Click the Connect account button.
7. Next, a dialogue box will appear, prompting you to authorize the connection. Click the Authorize button to do so.
8. Confirm the connection on the following pop-up window by clicking on the Connect button.

You can also link another Mastodon account by clicking the Connect one more account button and following the indications.

Open the Mastodon connection to other website users

Additionally, you can extend the Mastodon connection to all blog users:

1. Click the arrow beside the Mastodon sharing option.
2. Select the Connection available to all administrators, editors, and authors option. This ensures that any other users connected via Jetpack can automatically publish posts through this Mastodon connection.

Note that by opening the Mastodon social connection to other Jetpack users, these users can only share their posts on Mastodon. They don’t have access to anything else; for example, they cannot access your Mastodon account(s) directly.

Reset Mastodon connection

If you experience issues with Jetpack Social sharing to your Mastodon account, such as posts failing to publish, outdated permissions, or connection errors, resetting the connection can often resolve the problem.

To do this, you’ll first need to revoke Jetpack’s access from within your Mastodon account settings:

1. Log in to your Mastodon instance and navigate to Preferences → Account → Authorized apps (or Settings → Account → Authorized apps, depending on your instance).
2. Locate the Jetpack entry in the list. You’ll see the permissions it was granted, along with the date it was originally authorized.
3. Click the “✕ Revoke” button next to the Jetpack entry to remove its authorization.
4. Once revoked, return to your WordPress site and navigate to Jetpack → Social (or Tools → Marketing → Connections on WordPress.com).
5. Click Connect next to Mastodon and follow the prompts to re-authorize Jetpack with your Mastodon account.

After reconnecting, Jetpack Social will be issued a fresh set of credentials. Try publishing or sharing a test post to confirm that the connection is working as expected.

Note that revoking and reconnecting will not affect your existing Mastodon posts or followers: it only resets the authorization between Jetpack and your Mastodon instance.

Troubleshooting Jetpack Social Mastodon connections

When you think something is not working properly between Jetpack and your Mastodon profile, always check first that your Jetpack connection is working properly—Jetpack Social will not work correctly otherwise. If you continue to have trouble with Jetpack Social, look at our dedicated Jetpack Social Troubleshooting page.