Mastodon Migration to Pixelfed: Image-Focused Alternative

You want to move from Mastodon to Pixelfed because your social media focus has shifted from text-based microblogging to photo sharing. Mastodon is built around short messages and conversations, while Pixelfed is designed specifically for images and visual storytelling. This article explains the key differences between the platforms, the steps to migrate your account data, and what you cannot carry over during the move.

Why Mastodon and Pixelfed Are Different Platforms

Mastodon runs on the ActivityPub protocol and focuses on text posts with optional media attachments. Pixelfed also uses ActivityPub, but it is built around image galleries, albums, and a photo-first interface. The user experience, content discovery, and moderation tools differ significantly.

Pixelfed supports ActivityPub federation, meaning you can follow Mastodon users from Pixelfed and vice versa. However, the platforms are not identical clones. Pixelfed has no direct message feature, no polls, and no character limit. Mastodon lacks Pixelfed’s album creation, image filters, and story features.

When you migrate from Mastodon to Pixelfed, your followers on Mastodon do not automatically follow your new Pixelfed account. The account move protocol built into Mastodon works only between Mastodon instances. Pixelfed does not implement that same handshake. You must inform your followers manually or through a pinned post on your old Mastodon profile.

Steps to Migrate From Mastodon to Pixelfed

Follow this process to export your Mastodon data and import it into Pixelfed. The steps assume you already have a Pixelfed account on an instance of your choice.

1. Export your Mastodon archive
   Log in to your Mastodon account. Go to Preferences > Import and export > Export. Click the Request your archive button. Mastodon prepares a ZIP file containing your posts, media, and account metadata. The process may take a few minutes. Download the archive when the button changes to Download your archive.
2. Prepare the archive for Pixelfed
   Pixelfed imports only the posts and media from the Mastodon export. The archive contains an index.html file, a CSV file with your posts, and a media folder. Do not modify the folder structure. Keep the ZIP file intact.
3. Go to Pixelfed import settings
   Log in to your Pixelfed account. Click your profile icon in the top right corner. Select Settings from the dropdown menu. In the left sidebar, click Import from Mastodon.
4. Upload the Mastodon archive
   On the Import from Mastodon page, click the Choose File button. Select the ZIP file you downloaded from Mastodon. Click Upload. Pixelfed processes the file and imports your posts and images. This may take several minutes depending on the file size.
5. Verify imported content
   After the import completes, check your Pixelfed profile. Your posts from Mastodon appear as individual image posts. Captions, alt text, and media files transfer correctly. Direct replies to other Mastodon users may not carry over because Pixelfed does not support threaded conversations.
6. Inform your Mastodon followers
   Post a message on your Mastodon account announcing your move to Pixelfed. Include your Pixelfed profile URL. Pin this post to your Mastodon profile so visitors see it first. Remind followers that they need to follow your new account manually.

What Does Not Transfer During the Migration

The Mastodon-to-Pixelfed import is not a full account migration. Several data types do not transfer.

Followers and Following Lists

Pixelfed does not accept follower transfers from Mastodon. Your followers on Mastodon stay on Mastodon. You must rebuild your follower network on Pixelfed by having people follow your new account. Similarly, the accounts you followed on Mastodon are not carried over to Pixelfed.

Direct Messages and Conversations

Mastodon supports private direct messages. Pixelfed does not have a direct message feature. Any private conversations you had on Mastodon remain on Mastodon. They are not included in the export archive.

Polls and Poll Results

Mastodon allows polls in posts. Pixelfed does not support polls. If your Mastodon archive contains posts with polls, those posts are imported as text-only posts without the poll data. The poll results are not preserved.

Bookmarks and Favorites

Your bookmarked posts and favorited posts on Mastodon are not exported. These are stored per-account on the Mastodon instance and are not included in the standard archive.

If Content Appears Missing After Import

Some users report that imported posts appear without images or captions. This usually happens when the archive file is corrupted or too large. Pixelfed has a file upload limit of 50 MB for the import archive. If your archive exceeds this size, reduce the export by deleting older media from Mastodon before requesting the archive.

Another common issue is duplicate posts. If you run the import multiple times, Pixelfed may create duplicate entries. Check your profile after the first import and do not re-upload the same archive.

Item	Mastodon	Pixelfed
Primary content type	Text posts with media	Image galleries and albums
Character limit	500 characters default	No character limit
Direct messages	Supported	Not supported
Polls	Supported	Not supported
Follower transfer	Supported between Mastodon instances	Not supported
Album creation	Not supported	Supported
Image filters	Not supported	Supported
ActivityPub federation	Yes	Yes

Moving from Mastodon to Pixelfed is a one-way data transfer, not a live synchronization. You can export your Mastodon archive and import it into Pixelfed to preserve your posts and media. Your followers, direct messages, and polls do not come along. After the import, pin a post on your Mastodon profile with your new Pixelfed URL. For ongoing cross-posting, consider using a tool like Crossposter that supports both platforms.