Manage Actor Account Identity
Overview
Manage the actor account identity so remote readers immediately understand who is publishing and what kind of account it is. This makes authors, organizations, channels, and automated feeds easier to recognize and trust.
This solves two common problems. First, remote followers need a clear idea of who is posting, especially when a Joomla site publishes on behalf of a newsroom, association, foundation, or automated feed. Second, the default outbound object type should match the kind of content the actor usually publishes, so new posts are typed consistently.
Use this procedure when a local actor already exists and you want to refine how that actor is presented and serialized for Fediverse discovery. After you save the changes, the actor editor keeps the new account identity for future requests, and new public actor documents use the updated profile metadata.
Before you begin
- A local actor must already exist. If the actor has not been provisioned yet, create it first from the Actors view.
- You need permission to edit actor records in
Components -> Fediverse. - If you want to use
Organization accountorChannel account, the site must have an activeProlicense. Free and Personal installations can still usePersonal profileandService / Bot. - Decide what remote servers should see:
- the public account type
- the display name
- the short summary or description
- the website URL, if you want the actor document to point to a public page
- the profile image URL, if the actor should expose a recognizable avatar
- the header image URL, if the actor should expose a wider banner image
- up to three short profile facts, if the actor should expose labeled identity details such as region, language, or role
- one published Joomla article by the actor, if you want to mark a public introduction or profile post
Steps
- Open
Components -> Fediverse -> Actors. - Select the local actor you want to change and click
Edit. - In
Account Identity, chooseAccount Type.- Personal profile – Use this for a normal author or
individual account. It is published as an ActivityPub
Person. - Service / Bot – Use this for an automated
publisher, integration, or machine-managed feed. It is published as an
ActivityPub
Service. - Organization account (Pro) – Use this when the
actor represents an institution, foundation, association, company, or
newsroom rather than a person. It is published as an ActivityPub
Organization. - Channel account (Pro) – Use this when the actor
represents a shared publishing channel, topic stream, or brand feed. It
is published as an ActivityPub
Group.
- Personal profile – Use this for a normal author or
individual account. It is published as an ActivityPub
- Fill in the profile fields for the identity you want remote servers
to read.
- Display Name – The public label shown in the actor
document, such as
Example FoundationorTown Hall News. Use the name readers should recognize immediately. - Summary – A short description of what the actor publishes or represents. This is useful when the handle alone does not explain the account.
- Website URL – An optional absolute URL for the
site, profile page, or landing page that explains the account in more
detail. If the linked page points back to this actor profile with
rel="me", Joomla Fediverse marks the link as verified after you save. - Profile Image URL – An optional absolute image URL for the actor avatar. Use a stable public image URL that remote servers can fetch.
- Header Image URL – An optional absolute image URL for a wider profile banner. Use a stable public image URL that remote servers can fetch.
- Featured Introduction Content – An optional published Joomla article by the same actor. Use this when one post should act as the actor’s canonical introduction or profile post.
- Profile Facts – Optional labeled facts shown as
public profile metadata. Use short labels such as
Region,Language, orRole, and keep the values concise and readable.
- Display Name – The public label shown in the actor
document, such as
- In
Publishing Defaults, choose the defaultObject Typefor new outbound content.- Note (status update) – Best for short-form posts and status-style updates.
- Article – Best for standard Joomla article federation and most editorial publishing.
- Image – Best when the actor mainly publishes image-first updates.
- Video – Best when the actor mainly publishes video-first updates.
- Click
Saveto return to the Actors list, or clickApplyto stay on the same editor page after saving.
Check your result
- A confirmation message appears saying that the actor settings were saved.
- Reopen the same actor and confirm that
Account Type,Display Name,Summary,Website URL,Profile Image URL,Header Image URL,Featured Introduction Content,Profile Facts, andObject Typestill show the saved values. - If the linked site points back to the actor profile with
rel="me", confirm that the actor editor now shows the website link as verified. - Open the actor’s public profile URL in a browser and confirm it now
shows a readable actor page with the saved identity details and an
ActivityPub JSONlink. - Open the actor’s ActivityPub JSON view and confirm it exposes the
saved identity fields such as
type,name,summary,url,icon,image,attachment, andfeatured.
Troubleshooting
Organization or channel options are disabled
- Likely cause: The site is running on the
FreeorPersonalplan, or theProlicense is expired. - Solution: Keep using
Personal profileorService / Bot, or activate a validProlicense and reopen the editor.
The actor saves, but remote servers still show the old identity
- Likely cause: A remote server has cached the previous actor document.
- Solution: Confirm the saved values in the Joomla actor editor first. Then wait for the remote server to refresh the actor document, or trigger a new interaction that causes the remote side to fetch the actor again.
New posts still look wrong after changing the object type
- Likely cause: Existing federated posts keep the type they were published with before the change.
- Solution: Publish new content after saving the new default, or republish the content that should use the new type.
Saving fails with a plan or validation error
- Likely cause: The selected account type is not available on the current license, or one of the submitted values is invalid.
- Solution: Switch back to an allowed account type, review the entered values, and save again. If you entered a website URL, profile image URL, or header image URL, make sure each one is a complete absolute URL.
The website link does not show as verified
- Likely cause: The linked page does not point back
to this actor profile with
rel="me", or the linked page could not be fetched when you saved the actor. - Solution: Add a reciprocal
rel="me"link on the external page, save the actor again, and check the verification status message belowWebsite URL.