Understand Fediverse Compatibility Expectations

Overview

Use this guide to set realistic expectations before you promise a specific Fediverse experience to editors, authors, or remote followers. It helps you avoid support churn by explaining what Joomla Fediverse controls directly and what still depends on the remote server receiving the post.

Joomla Fediverse publishes standards-based ActivityPub content, but remote Fediverse software still decides how that content is displayed and moderated. After you work through this guide, you should know which differences are normal, which settings you can tune inside Joomla, and when you need to test with a specific remote server.

Before you begin

Joomla Fediverse is installed and the dashboard diagnostics are available.
You have at least one local actor and can publish a test article.
You can access at least one remote Fediverse account or test server if you want to confirm real-world behavior.

Steps

Start with the product boundary.
- Joomla Fediverse is a federated publishing channel for Joomla.
- It is not a Mastodon replacement and does not control how every remote server renders long-form content.
Expect post presentation to vary across remote servers.
- Some servers show only a teaser plus a link back to the Joomla article.
- Some servers show more of the article text directly in the timeline.
- Rich HTML may be simplified, stripped, or presented differently.
Expect media handling to vary.
- Some servers show federated article images prominently.
- Some servers minimize images, collapse them, or show only a link preview.
- Good Joomla alt text still matters because it gives remote readers and assistive technology a better fallback when the image is shown.
Expect hashtag and metadata handling to vary.
- Some servers surface hashtags strongly in discovery.
- Some servers make Joomla-tag-derived hashtags less visible than in-post hashtags.
- Profile metadata, actor images, and other presentation details may appear differently or not at all.
Expect interaction and moderation behavior to vary.
- Follow approvals, replies, boosts, and delivery timing depend partly on the remote server’s software and moderation policy.
- A successful local publish does not guarantee identical remote presentation or immediate interaction visibility everywhere.
Use Joomla Fediverse controls when the remote presentation matters.
- Review the article’s Fediverse tab before publishing.
- Use Use intro text and the custom federated text option when the article opening needs a clearer standalone message.
- Choose the federated image source deliberately.
- Choose the hashtag source that best matches the audience you are targeting.
Test with the remote servers that matter to your audience.
- Publish a non-critical test article first.
- Confirm how it appears on the target server.
- Adjust the per-article Fediverse settings if the result is too long, too short, too image-heavy, or missing useful discovery cues.

Check your result

You know which parts of the federated experience Joomla controls directly.
You know which differences come from remote server behavior rather than a local Joomla defect.
You have a plan to test important publishing workflows against the servers your audience actually uses.

Troubleshooting

A remote server shows only a short teaser

Likely cause: That server prefers a brief preview instead of showing the full federated article text.
Solution: Keep Include article link enabled and adjust the intro or custom federated text so the teaser still makes sense on its own.

The remote post does not show the image the way you expected

Likely cause: The remote server handles article images differently, or the selected Joomla image is not the best fit for federation.
Solution: Try a different image source in the article’s Fediverse tab and confirm the Joomla alt text is present.

Hashtags look different from what the editor expected

Likely cause: The selected hashtag source and the target server’s discovery UI do not behave the same way.
Solution: Test article text, Joomla tags, and both on a non-critical post, then standardize on the mode that gives the clearest result for your audience.