Make an Actor Easier to Discover

Overview

Use this procedure when a local actor is already publishing, but remote readers still do not immediately understand who the account represents or why they should follow it. A complete actor profile and clear public publishing pattern make it easier for other Fediverse servers and readers to recognize the account, trust it, and find its posts through normal federation activity.

This matters especially for Joomla Fediverse because it is designed as a publishing server. It exposes local actors, article-based publishing, and discovery endpoints, but it does not try to reproduce every Mastodon profile feature. That means discoverability currently depends on strong actor identity, a correct public base URL, and consistently published public content rather than on Mastodon-specific controls such as pinned posts or profile reach toggles.

Use this procedure after initial setup is complete and at least one local actor exists. When you finish, the actor will present clearer public identity data and publish content in a way that is easier for remote readers to understand and follow.

Before you begin

• The site must already be federating correctly. If setup is incomplete, finish the first-time setup guides first.
• You need permission to edit Fediverse actors and component options in Components -> Fediverse.
• A local actor must already exist for the Joomla user or publishing identity you want to improve.
• Decide how the actor should be understood remotely:
  • whether it represents a person, a service, an organization, or a channel
  • the public display name readers should recognize
  • a short first-line summary that explains the actor clearly
  • the public website URL you want remote readers to visit for more context

Steps

1. Confirm the site uses the correct public federation address.
2. Open Components -> Fediverse, click Options, and verify Public base URL.
   • Public base URL - This is the public address remote servers use for discovery and actor lookups. It must be the externally reachable canonical URL of the site. If this value is wrong, discoverability problems will continue even if the actor profile is complete.
3. Open Components -> Fediverse -> Actors, select the actor you want to improve, and click Edit.
4. In Account Identity, choose the account type that matches the actor’s real role.
   • Personal profile - Use this for an individual author or editor.
   • Service / Bot - Use this for an automated feed or machine-managed publisher.
   • Organization account (Pro) - Use this when the actor represents an institution, newsroom, association, company, or foundation.
   • Channel account (Pro) - Use this when the actor represents a shared topic stream, publication channel, or brand feed.
5. Fill in the public profile fields with concrete, recognizable values.
   • Display Name - The main public label remote readers see. Use the human-readable name people should recognize immediately.
   • Summary - A short description of what the actor publishes or represents. Put the clearest explanation in the first line, because many Fediverse readers and discovery views only show a short excerpt.
   • Website URL - An absolute https:// URL that gives readers a trustworthy page with more context, such as the publication homepage, author page, or organization site. If that page links back to the actor profile with rel="me", Joomla Fediverse can mark it as verified.
   • Profile Image URL - An absolute image URL that gives the actor a recognizable avatar in remote clients and discovery views.
   • Header Image URL - An absolute image URL that gives the actor a wider banner in remote clients and profile views that support it.
   • Featured Introduction Content - A published Joomla article that acts as the actor’s canonical introduction or profile post when remote readers want one clear item to inspect first.
   • Profile Facts - Short labeled facts such as Region, Language, Role, or Coverage that help remote readers understand the publishing identity quickly.
6. Set the default Object Type so new outbound posts match the actor’s normal publishing style.
   • Article - Best for most Joomla editorial publishing.
   • Note - Best for short status-style updates.
   • Image - Best when the actor mainly publishes image-first content.
   • Video - Best when the actor mainly publishes video-first content.
7. Click Save.
8. Publish a clear public article from the Joomla user mapped to this actor.
   • Use a title and opening paragraph that explain who the actor is or what it publishes.
   • Include relevant hashtags in the article content when appropriate, because hashtags remain a practical discovery path across the Fediverse.
   • If this is a new actor, publish a short introduction article first so remote readers have one obvious public post to inspect.
9. Keep publishing consistently under the same actor identity so followers and remote servers see a stable profile and topic pattern over time.

Check your result

• The actor editor keeps the saved Account Type, Display Name, Summary, Website URL, Profile Image URL, Header Image URL, Featured Introduction Content, Profile Facts, and Object Type.
• If the website proves ownership through a reciprocal rel="me" link, the actor editor and public actor page both show that the link is verified.
• The actor’s public profile URL now shows a recognizable actor page in a browser, not only raw JSON.
• The actor’s public ActivityPub JSON now exposes the updated identity fields such as type, name, summary, url, icon, image, attachment, and featured.
• A newly published article federates from that actor and shows the updated public identity.
• A remote reader who opens the actor or one of its posts can understand who the account represents without needing extra explanation.

Troubleshooting

Remote servers still show the old actor profile

• Likely cause: The remote server cached the previous actor document.
• Solution: Confirm the new values are saved in Joomla first, then wait for the remote server to refresh its cache or trigger a new interaction that causes it to fetch the actor again.

The actor is clear, but remote servers still cannot discover it

• Likely cause: Public base URL is wrong, not publicly reachable, or does not match the site’s real external address.
• Solution: Recheck the component options, confirm the URL is reachable from outside the site, save the corrected value, and run the diagnostics wizard again.

Readers still do not understand what the actor is for

• Likely cause: The display name is too generic, the summary is blank or vague, or the first public article does not explain the publishing purpose.
• Solution: Rewrite the Display Name and Summary to be more specific, then publish a clearer introduction-style article under that actor.

I need Mastodon-style profile features such as pinned posts, profile images, or reach controls

• Likely cause: Joomla Fediverse is currently optimized for publishing-server workflows, not for full Mastodon profile parity.
• Solution: Use the supported identity and publishing steps in this guide today. Treat pinned-profile behavior, profile media, and similar discovery features as product gaps rather than configuration mistakes.

Related tasks

• Configure Fediverse Component Options
• Create a Local Actor
• Manage Actor Account Identity
• Publish a Federated Article