You want to see Pixelfed photo posts directly in your Mastodon home timeline. Pixelfed is a federated image-sharing platform that speaks the same ActivityPub protocol as Mastodon. This means users on either service can follow each other and exchange content without leaving their preferred app. This article explains how to connect your Mastodon account with Pixelfed so that image feeds appear in your Mastodon timeline. You will learn the exact steps to find, follow, and interact with Pixelfed users from Mastodon.
Key Takeaways: Federating Mastodon With Pixelfed Image Feeds
- Search field in Mastodon: Enter the full Pixelfed username including instance domain to find and follow Pixelfed accounts.
- Follow button on Pixelfed profile: Click the Follow button from a Pixelfed user's profile page to send a follow request that Mastodon will process.
- ActivityPub handshake: Both platforms use the same federation protocol to exchange posts, likes, and boosts automatically after a follow is accepted.
Understanding How Federation Works Between Mastodon and Pixelfed
Mastodon and Pixelfed both use the ActivityPub protocol to share content across servers. When you follow a Pixelfed user from your Mastodon account, your instance sends a follow request to the Pixelfed server. The Pixelfed server delivers new posts from that user to your Mastodon home timeline. The process is identical to following a user on another Mastodon instance. No special configuration or bridge software is needed.
Pixelfed posts appear as regular statuses in Mastodon. Each post displays the image file, a caption, and any hashtags the user added. You can boost, favorite, or reply to Pixelfed posts from Mastodon. Replies from Mastodon users appear as comments on the original Pixelfed post. This two-way interaction works because both platforms implement the same ActivityPub standards for object creation, delivery, and interaction.
What Content Gets Federated
Only public posts from Pixelfed users appear in Mastodon timelines. Private or followers-only posts are not visible to Mastodon users. Pixelfed image albums are displayed as individual posts in Mastodon, with each image getting its own status entry. Video posts from Pixelfed also federate, though the playback experience depends on the Mastodon client you use. Direct messages between the two platforms are not supported.
Prerequisites for Federation
You need an active account on any Mastodon instance that allows federation. Most Mastodon servers federate with Pixelfed by default unless the instance administrator has blocked the Pixelfed domain. You also need a Pixelfed account or at least know the exact username of a Pixelfed user you want to follow. If you do not have a Pixelfed account, you can still follow public Pixelfed users from Mastodon without signing up for Pixelfed.
Steps to Follow a Pixelfed User From Mastodon
- Get the full Pixelfed username
Find the Pixelfed user's complete handle. It looks like @username@pixelfed.social or another Pixelfed instance domain. The username must include the instance domain after the @ symbol. If you only have the local username, ask the user for their full federated address. - Open the Mastodon search field
In your Mastodon web interface or mobile app, click or tap the search magnifying glass icon. Type the full Pixelfed handle into the search box and press Enter. - Select the Pixelfed account from search results
Mastodon displays matching accounts from its own instance and from federated servers. Look for the Pixelfed user in the results. Click the account name to open their profile page. - Click the Follow button
On the Pixelfed user's profile page, click the Follow button. Mastodon sends a follow request to the Pixelfed server. If the Pixelfed user has approved your request or has open follows, the follow is immediate. Their public posts begin appearing in your Mastodon home timeline. - Verify the follow worked
Go to your Mastodon home timeline and refresh the page. You should see the Pixelfed user's recent image posts. If no posts appear after 5 minutes, check that the Pixelfed user has public posts and that your Mastodon instance can reach the Pixelfed server.
Alternative Method: Follow From the Pixelfed Profile Page
- Open the Pixelfed user's profile in a browser
Navigate to the Pixelfed user's profile URL, for example https://pixelfed.social/username. You do not need to log in to Pixelfed for this step. - Copy the profile URL
Copy the full URL from the browser address bar. The URL contains the instance domain and the username. - Paste the URL into Mastodon search
Return to your Mastodon interface. Paste the Pixelfed profile URL into the search field and press Enter. Mastodon resolves the URL and displays the Pixelfed account. - Click Follow
Click the Follow button on the resolved account profile. The federation process is the same as entering the username directly.
Common Issues When Federating With Pixelfed
Pixelfed Account Does Not Appear in Mastodon Search
If the Pixelfed user does not show up in Mastodon search results, the Pixelfed instance may be blocked by your Mastodon server administrator. Contact your instance admin to check if the Pixelfed domain is in the server's blocklist. Another cause is that the Pixelfed user has deleted or suspended their account. Verify the username is accurate and the user exists by visiting their profile directly in a browser.
Pixelfed Posts Do Not Show in Timeline After Following
If you successfully followed a Pixelfed user but see no posts, the user may have a private account. Only public posts federate. Ask the user to check their post visibility settings. Also confirm that your Mastodon instance is not experiencing federation delays. Try following another Pixelfed user to test if the issue is specific to one account or global.
Cannot Boost or Favorite Pixelfed Posts
Mastodon allows boosting and favoriting any public post from a federated platform. If the interaction buttons are missing or disabled, the Pixelfed user may have disabled those features on their account. Some Pixelfed instances limit interactions from external servers. Check the Pixelfed user's profile settings for interaction permissions.
Mastodon vs Pixelfed: Federation Feature Comparison
| Item | Mastodon | Pixelfed |
|---|---|---|
| Primary content type | Short text posts with optional media | Images and albums with captions |
| Federation protocol | ActivityPub | ActivityPub |
| Follow from external service | Yes, by searching full handle | Yes, by searching full handle |
| Boost or repost across platforms | Yes, visible as boosts | Yes, visible as reposts |
| Private posts visible to external users | No | No |
| Direct messages across platforms | No | No |
You can now see Pixelfed image feeds directly inside your Mastodon home timeline by following public Pixelfed accounts. Try following a Pixelfed photographer or artist to test the federation. For a richer experience, enable media visibility in your Mastodon timeline settings so images load automatically.