Skip to content

Role sync — Discord roles → VRChat group roles

Map Discord roles to VRChat group roles on the dashboard's Role Sync page. LogDog then adds or removes the mapped group roles for eligible linked members. You can also configure mappings with /config → Role Sync.

Requirements

Requirement Details
Your access Administrator to configure; Manage Server or higher to view mappings and sync history.
LogDog in Discord Access to member and role information. Account linking separately needs Manage Roles to assign its Discord roles.
LogDog in VRChat View Audit Log and Assign Roles, with sufficient group-role rank to manage the target member.
Plan Free.

Set up account linking first. See the permissions matrix for platform-specific access.

Set up on the dashboard

  1. Open Role Sync for your server.
  2. Check that LogDog can assign roles in your VRChat group. Grant Assign Roles to the assigned VRChat account's group role if needed.
  3. Select a Discord role and the VRChat role it should grant.
  4. Select Add mapping. LogDog begins syncing eligible members who already hold it.
  5. Add any other role pairs you need.

One Discord role can grant multiple VRChat roles. If several Discord roles grant the same VRChat role, a member keeps it while they hold any qualifying mapped role.

Set up in Discord

Run /config → Role Sync, check the permission status, choose the role pair, and select Add mapping. Use Refresh after changing the VRChat permission.

Who gets synced

Only members with an eligible Discord–VRChat link can sync:

  • With cross-server trust off, the member must have verified in this server.
  • With cross-server trust on, an existing LogDog link from another server is enough; a separate link-button action here is not required for VRChat role sync.

The member must also belong to the VRChat group for its role to be assigned.

What happens after setup

  • Gaining a mapped Discord role adds its VRChat role.
  • Losing all Discord roles that grant a VRChat role removes that group role.
  • Leaving the Discord server or using /unlink queues removal of synced group roles.
  • Re-sync all on the dashboard, or Re-sync now in Discord, checks for differences and queues the needed changes.

Large initial syncs can take hours. LogDog spaces out changes to reduce VRChat rate limits; temporary errors can still delay completion.

Change or remove a mapping

Pause or delete a mapping on Role Sync. Removing a mapping stops future syncing for it and leaves already-assigned VRChat roles in place. Remove those roles in VRChat if you also want to revoke them.

Troubleshooting

Check the dashboard's sync status/history and LogDog's failure summary. If VRChat refuses a change because the member has equal or higher group rank, raise the LogDog account's role appropriately or manage that member in VRChat. Group owners cannot be managed by a lower-ranked account.

For a missing member, check their account link, cross-server trust, Discord role, and VRChat group membership before requesting another sync.