Connect a Discord server
To start using Discord Analytics, connect your Discord server from the CollabOS dashboard.
Before connecting
You need:
- a Pro or Agency workspace
- the Discord server ID
- the server name
- optionally, a Discord role ID to track a specific group of members
Connecting the server
To connect a Discord server:
- 1.Open your workspace dashboard.
- 2.Go to Community Analytics.
- 3.Click Add bot if the bot is not already in your server.
- 4.Enter the Discord server ID.
- 5.Enter the server name.
- 6.Optionally enter a tracked role ID.
- 7.Click Connect Discord.
After connecting
Once connected, CollabOS syncs the server data available to the workspace.
The dashboard can then show:
- current server members
- member join dates
- bot accounts
- member activity
- message counts
- X / Twitter links
- active and inactive members
Full analytics page
After connecting, open the full analytics page to view the complete dashboard.
The full analytics page gives more space for charts, the full member table, backfills, CSV exports, X links, and moderation actions.
Tracked role ID
The tracked role ID is optional.
If your workspace adds a tracked role ID, the dashboard can filter analytics to only show members with that Discord role.
This is useful for communities that only want to analyze:
- holders
- verified members
- allowlist members
- premium members
- special role members
- a specific community segment
If no role ID is added, CollabOS tracks the connected server more broadly.
Reconnect / sync server
If the server is already connected, reconnecting with the same server ID can be used to sync server members again.
This is useful when:
- new members were added
- roles changed
- bot accounts need to be updated
- slash commands need to be registered again
- the dashboard needs fresh member data
Do not reset the connection unless you intentionally want to remove the Discord connection and clear analytics for that workspace.
💡Best practices
Before connecting:
- make sure the bot has access to the channels you care about
- use the correct server ID
- add a tracked role only if you need role-based filtering
- run a backfill after setup if you want older messages included