> For the complete documentation index, see [llms.txt](https://dework.gitbook.io/product-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dework.gitbook.io/product-docs/guides-for-orgs/connecting-to-discord.md). # Connecting to Discord ## What is the Discord integration? With the Discord integration you can do a number of things on Dework that help make the platform work the way you want to engage your team and community. ## How to connect Dework to Discord **Step 1**: In the space/project that you want to connect to your Discord server, click on `Connect to Discord` at the top. ![Settings > Discord Integration > Connect to Discord](/files/RJd7MbVEO9GTvtyVOzQ6) **Step 2**: You will redirected to a Discord page where you can select which server you want to connect to the Dework space. Select the server from the dropdown and click `Continue`. ![Select the server to connect to Dework](/files/mFgnfzPXjycS5yi9T9Wy) **Step 3**: By clicking `Authorise`, you will add the Dework bot to your server with the requested permissions so that it can operate seamlessly. ![Authorise adding the Dework bot to your serve](/files/nXbvQXa11JfZN0YM3iGr) ## **What Discord integrations are there** Once authorised you will be returned to Dework where you can customise the integration on how you want to keep your server updated about the project's progress. There are 3 parts for Discord integration: **Good for Discussions**, **Tasks Awareness** and **Community Suggestions**, where you can find what suits your need most. ![Start customising the integration](/files/7m0Hxt0oAlN7GNnoJAKA) Review how you want Dework updates to get shared to your Discord server. **Good for Discussions** * A thread per task on the channel you select is especially great for projects where you want to discuss or share feedback on each of this space/project's tasks. ![Task discussion thread integration for Discord](/files/IIUMs0FwMlhc0TitGv7S) **Tasks Awareness** * A message sent to a Discord channel when a task is created can be used to inform your community of new tasks/bounties on this space/project. * The status board with all open tasks option posts a message that syncs with Dework to show all open tasks for this space/project. ![Task awareness integrations for Discord](/files/MC1BzC7G6wbAoCKXzPkO) **Community Suggestions** * A message sent to a Discord channel when a community suggestion is created can keep your team (or community) up to date with the latest inputs, so they can upvote or learn more. * The community suggestions status board provides you with a synced list of the top voted community suggestions for this project directly in a Discord server channel. ![Community Suggestion integrations for Discord](/files/gqjX5ceIuTZSjJr9Zz3n) #### **Activity Feed** * A message sent to a Discord channel when an activity feed update is posted on Dework can ensure more visibility or action from contributors ![Activity Feed integration for Discord](/files/mqf6J79H7MeLUFfu1yab) ## How to setup a Discord integration ### Create a thread when a task is assigned to someone **Step 1**: Click `Connect` next to `Create a thread when a task is assigned to someone`. Then select which channel on your Discord server you want to connect the Dework space/project to. ![Select the channel for the Discord integration](/files/ClCd0SO47P41FhNCq8WX) **Step 2**: Then click `Connect` and you're all set! ![Now this Discord channel will have threads created for assigned tasks](/files/25unUsk8kxK9p3bhL9np) {% hint style="success" %} After connecting to the Discord channel, you will start receiving updates directly in your Discord as tasks get assigned and move into progress. {% endhint %} ![Sample Discord updates and thread creation for tasks in Dework](/files/C4D11k4RQwEgBWkSvUqo) ### **Send a message when a task is created** Click `Connect` next to `Send a message when a task is created` to be able to select the channel you want to see all the newly created tasks. Then select the relevant channel from the dropdown. ![Connectiion to Discord channel for task creation message](/files/jjnfxt16bvZBIvNUHpP6) {% hint style="success" %} After connecting to the Discord channel, you will start receiving updates directly in your Discord as tasks get created. {% endhint %} ![Task creation message in the Discord channel](/files/isoBUMaN6bByqr9k1upG) ### **Post a status board with all open tasks** Click `Connect` next to `Post a status board with all open tasks` to connect to the channel you want to have an overview of open tasks. Then select the channel from the dropdown. ![Connectiion to Discord channel for task status board](/files/JSVkM5fcM7cbhKN1nYBo) {% hint style="success" %} After connecting to the Discord channel, you will start seeing the status board for all open tasks from the Dework space/project directly in your Discord. {% endhint %} ![Task board message in the Discord channel](/files/KeSj5Fw7soxDTv1U3r9M) ### **Send a message when a community suggestion is created** Click `Connect` next to `Send a message when a community suggestion is created` to connect to the channel you want to be notified with newly created community suggestions. Then select the channel from the dropdown. ![Connectiion to Discord channel for community suggestion creation message](/files/nBTJt1nP2COlvrKfmxsa) {% hint style="success" %} After connecting to the Discord channel, you will start receiving community suggestion updates directly in your Discord as new suggestions get created. {% endhint %} ![Community suggestion message in the Discord channel](/files/3yAuiNy7OknjfWVX2ChB) ### **Post a status board with all community suggestions** Click `Connect` next to `Post a status board with all community suggestions` to connect to the channel you want to have a overview of community suggestion. Then select the channel from the dropdown. ![Connectiion to Discord channel for community suggestion status board](/files/SXYgPPr0rz3VjNZYrIoQ) {% hint style="success" %} After connecting to the Discord channel, you will start seeing the Community Suggestion status board that lists them directly in your Discord. {% endhint %} ![Community suggestion status board message in the Discord channel](/files/LH4hyKT3iWwB9IcoYumU) ### Send a message when the activity feed is updated Click `Connect` next to `Send a message when the activity feed is updated` to connect to the channel you want to be notified with newly created Activity Feed updates. Then select the channel from the dropdown. {% hint style="info" %} **Note**: Learn more about the Activity Feed on [Setup your first Space](/product-docs/guides-for-orgs/setup-your-first-space.md) {% endhint %} ![Connectiion to Discord channel for activity feed update message](/files/IAFiR1FY5YW8rAeVIIvt) {% hint style="success" %} After connecting to the Discord channel, you will start receiving activity feed updates directly in your Discord as new updates get created. {% endhint %} ![Activity Feed update in the Discord channel](/files/XGSRIZtxen3omIZ2freQ) ## Notes * You can also connect to Discord at the top of any space/project and then go to `Settings` to customise the Discord integration. ![Click on ⚙️ to customise the integration](/files/jf7LkvQ0lg1PPYKEzirk) * When you use nested a space/project under the one you setup with a Discord integration, the notifications of the nested space/project will be pushed to the same Discord channels.