Documentation
Discord integration
The Orbit Discord Integration will automatically ingest messages in your Discord server. We’ll create a member profile for every participant and an activity for every message, which allow you to see when a member joined your server, which categories and channels they are active in, and the specific messages sent.


The table below summarizes what is included in this integration:
Activities | - When a user joins the server
- New messages in a channel
- New replies to a message
- New replies in a thread |
Historical Import | - All of the above listed activities for 365 days retrospectively from the date of connecting the integration to Orbit
- Up to 100,000 messages (very active Discord servers may see less than 12 months of data due to this) |
Does not track or import | - Stickers or emoji reactions
- User defined roles
- If a user leaves the server |
By default, Orbit will import the last 12 months of messages with a limit of up to 100,000. If you need older historical imports, please reach out.
Integrating Discord with Orbit is a two-step process.
- Attach the Discord server to your Orbit workspace
- Configure the Orbit integration for your Discord server
Connect a Discord server to your Orbit workspace
First, navigate to the Integrations section of your workspace settings. To get started, click on the Discord icon in the Plug & Play Integrations section.

A modal like the one shown below will appear, click on Connect Discord to start the process. You will be redirected to the Discord authorization page.

Make sure that the correct Discord server is selected in the drop-down, then click "Continue". The app asks for read-only permissions. Finally, click "Authorize".

If successful, Discord will redirect you back to Orbit and you’ll see your linked Discord account, ready for configuration.
Configure the Orbit integration for your Discord server
Finally, you must configure the Orbit integration for your Discord server by selecting any channels you would like to import, as well as applying permissions when applicable.

Public channels
By default, Orbit will automatically import messages for any selected public channels.
Private channels
Orbit can also automatically import messages for any selected private channels, however you must first update the channel/category permissions in your Discord server.
To grant permission, apply the Orbit role to any private channels and/or categories.

Finally, now you can navigate back to Orbit and select any private channels to begin importing private messages.
Frequently Asked Questions
Why aren't my private messages showing up?
If you selected a private channel before granting the Orbit role permissions, then you will encounter the following warning icon:

To fix the issue and begin importing private messages, you can follow the instructions above, then re-select any private channels to try again.
Why aren't my server joined activities showing up?
If you are not seeing any activities created when a member joins your server, then you must enable the "New Member Messages" option in your Discord server settings.
Why is the Orbit bot offline?
After installing the Orbit bot on your Discord server, you may have noticed the bot appears offline:

This does not mean the installation was unsuccessful, messages will continue to be imported. The Orbit bot permissions are read-only. As a result, the bot does not need to appear online or interact with members in your Discord server.
Why do I see a difference between my member count in Discord and my Discord member count on Orbit?
Orbit’s historical import will initially import active members of your Discord server, which are members who have sent a message within the past year.
During the historical Discord import, Orbit will create new members and activities for any messages sent within the past year, but it will not add a member into Orbit if the member has been inactive in the Discord server. 'Server channel join’ activities will only be imported to Orbit after the Discord integration has been connected and is listening for these activities.
For troubleshooting check out:
- Discord integration
- Connect a Discord server to your Orbit workspace
- Configure the Orbit integration for your Discord server
- Public channels
- Private channels
- Frequently Asked Questions
- Why aren't my private messages showing up?
- Why aren't my server joined activities showing up?
- Why is the Orbit bot offline?
- Why do I see a difference between my member count in Discord and my Discord member count on Orbit?