Short answer: attach your image, click Edit on its thumbnail, and type a description. Mastodon calls it a media description, and people who use screen readers hear it in place of the picture. Most servers allow 1,500 characters.
Alt text matters more on Mastodon than on most networks. Many people only boost images that have a description, and some servers' rules ask for one. A post without alt text can quietly go nowhere.
The Quick Answer
| Question | Answer |
|---|---|
| Where do I add it? | Edit, on the attached image's thumbnail |
| How long can it be? | Usually 1,500 characters, set by your server |
| Can I add it after posting? | Yes, by editing the post |
| Does it work for video? | Yes |
How to Add Alt Text on Mastodon's Website
- Start a post and attach your image with the media button.
- Click Edit on the image's thumbnail.
- Type the description. The same screen lets you set the focal point for the preview.
- Apply, and post as usual. An ALT badge shows on images that have a description.
The 1,500-character figure is Mastodon's usual default, but each server sets its own limit, and apps can read it from the server.
How to Write Good Alt Text
- Say what matters. Describe what someone needs to get the post: "My cat asleep in a cardboard box, one paw hanging out," not "image of cat."
- Type out text in the image. For a screenshot of a post or a sign, the words are the point.
- Skip "image of". Screen readers already say it's an image.
- Keep the jokes in. Describe the punchline of a meme, not just its template.
- Don't use alt text to dodge the character limit. It's for people who can't see the image, not extra room for your post.
When Skyscraper Is the Better Way
Skyscraper makes alt text hard to forget and quick to write:
- Tap the image in the composer to open Add Alt Text. A counter shows how much room is left, using your server's own limit.
- Generate alt text: tap the generate button and Skyscraper writes a draft description on your device, with Apple Intelligence on iOS 27 and macOS 27 and a simpler on-device description on older systems. You can edit it, and if there's already text it asks whether to replace it or add to it.
- Alt Text Reminder: in Settings > Timeline & Posts > Alt Text Reminder, choose Remind Me to be asked before a photo or video without alt text goes out, or Require so it can't go out without one. It covers Mastodon and Bluesky posts and posts from the Share menu.
Skyscraper is the better way if you cross-post: when a post goes to Mastodon and Bluesky at once, Skyscraper holds the description to the smaller of the two limits so it fits both.
Frequently Asked Questions
How do I add alt text on Mastodon?
Attach the image, click Edit on its thumbnail, and type a description before you post.
How long can Mastodon alt text be?
Usually 1,500 characters. Each server sets its own limit.
Can I add alt text after posting on Mastodon?
Yes. Edit the post and add a description to the image.
Why do people on Mastodon care so much about alt text?
Screen reader users rely on it, and many people won't boost an image without one.
Can an app write alt text for me?
Skyscraper can generate a draft description on your device for you to check and edit.
Alt Text in Skyscraper
Alt text, Generate alt text and the Alt Text Reminder are free in Skyscraper for Mastodon and Bluesky. Skyscraper is free to download, and your one free account can be Bluesky or Mastodon. A second account, and features marked Pro, are part of Skyscraper Pro.
Get Skyscraper on the App Store
Blog readers get a deal: as a bonus for reading the blog, use promo code BLOG or this special link to get your first year of Skyscraper for $5.99 USD (or your local equivalent).