Skip to content

Guides

How to Schedule Mastodon Posts

By PostMediaAI6 min read

You can schedule Mastodon posts. Mastodon has supported scheduled posts in its API since version 2.7, so apps and schedulers can hold a post and have your server publish it later. You just won't find a "schedule" button in Mastodon's standard web composer, which is why many people assume it's not possible.

How scheduling works on Mastodon

Mastodon's API documentation explains it plainly. When an app creates a post and includes a scheduled time, the server doesn't publish it right away. It saves it as a scheduled post and publishes it when the time arrives. The documentation says:

  • The scheduled time must be at least 5 minutes in the future.
  • Scheduling was added in Mastodon 2.7.0, so any reasonably up-to-date server supports it.
  • Apps can list, reschedule and cancel scheduled posts through the scheduled posts API.

That last point matters: because the post sits on your server, not just in the app, it publishes even if the app or your phone is offline.

Why there's no schedule button in the web interface

Mastodon's own web interface focuses on posting now. Scheduling is exposed through the API for apps to use. So your options are:

  • A Mastodon app that offers scheduling in its composer. Check your app's post options.
  • A social media scheduler that supports Mastodon, which is useful if you also post to Bluesky, X, Threads or LinkedIn.

How to schedule a Mastodon post with a scheduler

  1. Add Mastodon as a channel in the tool.
  2. Enter your server's address (for example, mastodon.social or your own server) and sign in on your server's page to approve access.
  3. Write your post, add media, and set any content warning.
  4. Choose a date and time at least 5 minutes away.
  5. Schedule it and confirm it appears on the tool's calendar.

PostMediaAI lists Mastodon among its 30+ channels, alongside Bluesky, X, Threads and LinkedIn, so your text posts share one calendar. Our FAQ says most channels connect through the network's official sign-in, so we never see those passwords; see the FAQ. Every plan includes unlimited posts, and each connected account uses one channel slot, so a Mastodon account and a Bluesky account use two. See the pricing page for plan sizes.

Mastodon limits to plan around

From Mastodon's posting documentation:

  • Length: the default limit is 500 characters.
  • Links: every link counts as 23 characters, however long it is, and must start with http:// or https://.
  • Media: up to 4 images per post.
  • Visibility: four levels, so check that your scheduled post goes out with the visibility you intend.
  • Content warnings: you can hide a post's text behind a short warning, which many communities expect for certain topics.

Servers can differ

Mastodon is a network of independent servers. Each server publishes its configuration through the API, including its character limit, and some servers run modified software with different limits. If your post is near 500 characters, check your server's limit before relying on it.

Fediverse etiquette for scheduled posts

Mastodon communities tend to be sensitive to anything that feels like broadcast marketing. A few habits help scheduled posts land well:

  • Write for Mastodon. Copy that works on X or LinkedIn can feel out of place. Be direct and personal.
  • Use content warnings where your community expects them, such as for spoilers or heavy topics.
  • Add alt text to images. Many Mastodon users rely on it and notice when it's missing.
  • Use a few relevant hashtags, written in CamelCase such as #SmallBusiness so they're easier to read.
  • Don't schedule and vanish. Replies are where relationships form, so check back after a post goes live.

Pairing Mastodon with Bluesky

Mastodon and Bluesky are both decentralized networks, and many people post to both. The main differences to plan for:

  • Length: Mastodon defaults to 500 characters, while Bluesky's developer documentation sets a 300-character limit. Write the shorter version first, or trim the Mastodon version for Bluesky.
  • Handles: mentions use different formats. A Mastodon handle includes the server, like @name@server, which won't work on Bluesky.
  • Culture: both reward conversation, but Mastodon has stronger norms around content warnings and alt text.

PostMediaAI drafts posts shaped to each platform from a topic or a link, and the Shorter rewrite helps cut a Mastodon post down for Bluesky. You edit each version before scheduling. For a full walkthrough of Bluesky, see our Bluesky scheduling guide.

A simple weekly Mastodon plan

1. Schedule a backbone of two or three posts

Good candidates: a link to something you wrote with a real summary, a tip from your work, an open question to people in your field.

2. Keep conversation live

Boosts, replies and threads with other people work best in real time.

3. Batch-write once a week

Write the week's scheduled posts in one sitting. Add alt text and content warnings while you're at it, not at the last minute.

An example for a small open-source project:

  • Monday: release notes summary with a link and the one change most users will notice.
  • Wednesday: a "how do you use this feature?" question to gather real feedback.
  • Friday: a thank-you to a contributor, with their handle, for a merged fix.

4. Check the first one

When the first scheduled post goes live, open it on your server and check visibility, link previews and images.

For broader timing advice, see Social media scheduling guide: workflows, timing, and fewer mistakes. For keeping several accounts organized, see How to Manage Multiple Social Media Accounts Without Losing the Plot.

Common reasons a scheduled Mastodon post fails

  • The time was less than 5 minutes away, which the API rejects.
  • The post was longer than your server's character limit.
  • The app's access to your account was revoked in your server's settings.
  • Your server was down or had moved when the post was due.

Related guides

FAQ

Can you schedule posts on Mastodon?

Yes. Mastodon's API has supported scheduled posts since version 2.7.0. Use an app or scheduler that offers it, since the standard web composer doesn't show a schedule option.

How far ahead do Mastodon posts need to be scheduled?

At least 5 minutes in the future, according to Mastodon's API documentation.

How long can a Mastodon post be?

The default is 500 characters, and links count as 23. Servers publish their own configuration, so check yours if you're close to the limit.

Can I edit or cancel a scheduled Mastodon post?

Yes. Mastodon's scheduled posts API lets apps change the scheduled time or cancel the post. How you do it depends on the app or tool you used.

Will my scheduled post publish if my phone is off?

Yes. The scheduled post is stored on your Mastodon server, which publishes it at the set time.

Related guides: How to Auto Post to Instagram (and Reels), How to Schedule Reddit Posts Without Spamming and How to Schedule Google Business Profile Posts.

Sources

Platform rules change often. These are the official pages behind the limits and steps in this guide, checked when it was written:

← All articles

Related reading