> For the complete documentation index, see [llms.txt](https://good-alchemy.gitbook.io/fabric-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://good-alchemy.gitbook.io/fabric-documentation/guides/manage-open-source-issues.md).

# Fabric for open-source issues

Triage open-source issues with your team in Slack.

With [Fabric](https://www.tryfabric.com/), you can **send issue notifications to certain Slack channels.**\
\
For example, you can send newly opened issues in the `my-org/my-open-source-project` GitHub repository to the `#new-open-source-issues` channel.

![Create notification channels with granular filters.](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/BOvDrHfRrJOvnWOfh9Ve/Screen%20Shot%202022-01-05%20at%205.57.37%20PM.png)

**Have a lot of inbound issues?** Use our powerful filters.\
\
You can filter by GitHub repository and labels.

You can include and exclude certain labels. For example, you might want to exclude the `invalid` label.

![Issues with the feature request label will be sent to this channel, unless they have the invalid label.](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/35utF1b2ouPVB4iccBBs/Screen%20Shot%202022-01-05%20at%205.50.27%20PM.png)

In this example, issues with the `feature request` label will be sent to this channel, unless they have the `invalid` label.

![Receive new issues from contributors. Add details and collapse the issue when you're done.](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/ufDoHDHHdTXkNFbqJN2J/Screen%20Shot%202021-10-07%20at%206.12.08%20PM.png)

Use the buttons to add details to your issue.

![The issue message collapses when it's closed.](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/svIDxQ2Vezm6VknCKyr2/Screen%20Shot%202022-01-05%20at%206.33.46%20PM.png)

Click `Done editing` when you're done to collapse the issue. Closing the issue also collapses it. That's it!

## How it works

When an issue is created, or a certain label is added to an issue, Fabric will send a notification to your channel.

When setting up your notifications, you can filter by GitHub repository or labels. This lets you create many special types of channels, like `#bug-reports` or `#feature-requests`.

### A new issue is created

![](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/lHZY8ndSs1bGpszBGV7i/Screen%20Shot%202021-10-07%20at%206.12.08%20PM.png)

### Add details, comment, close

Click to add details, close out the issue, or add a message on the thread to comment.

If you have [Issue Room auto-creation turned on,](https://docs.tryfabric.com/admins/team-settings#auto-creating-issue-rooms) Fabric will automatically create an [Issue Room](/fabric-documentation/reference/issue-rooms.md) Slack channel, where you or your teammates can respond to the issue.

You can also view, edit, comment on, and close out the issue within the Issue Room.

![You can view, edit, and comment on the issue within the Issue Room.](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/PS2vWbb2UGqSuDXdLvzC/Screen%20Shot%202021-10-07%20at%206.12.33%20PM.png)

### **Optionally open an Issue Room**

**Issue Rooms two-way sync with GitHub,** so any comments from GitHub will send to the Issue Room. And any messages in the Issue Room will send to GitHub.

![Messages from the Issue Room sync to the issue.](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/oel47fKmKWBOiPhErLt8/Screen%20Shot%202021-10-07%20at%206.15.11%20PM.png)

![If a contributor opens a Pull Request for an issue, Fabric will send a message to the Issue Room.](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/TL9jpntheel2ntZtIQYU/Screen%20Shot%202021-10-07%20at%206.22.59%20PM.png)

When your issue is closed, Fabric archives your Issue Room as well.

## How to set it up

### Go to your Fabric dashboard

You can find your Notifications page in your Fabric Dashboard in Slack.

![](https://gblobscdn.gitbook.com/assets%2F-MhaDNLIUpkpQasYP_hs%2F-MjAPlF6Z8FaeLBs3Hen%2F-MjARK1VHCbIomJaS1RJ%2FScreen%20Shot%202021-09-09%20at%2012.43.21%20PM.png?alt=media\&token=2d17d695-ca27-4061-9ca8-305694fba64d)

To get to your Fabric Dashboard, click `Fabric` under `Apps` in your Slack sidebar.

If you don't see `Fabric` there, search for `Fabric` in your Slack search bar, and then click on the `Home` tab.

![](https://gblobscdn.gitbook.com/assets%2F-MhaDNLIUpkpQasYP_hs%2F-Mho_PCGHjtZUrL9zEFG%2F-MhohIxiHesj4aTv9MFl%2FScreen%20Shot%202021-08-23%20at%204.30.14%20PM.png?alt=media\&token=2d666e87-70c0-4189-92fc-a1799cb7b57b)

Find Fabric in the Slack sidebar or search for it in the Fabric search bar.

![](https://gblobscdn.gitbook.com/assets%2F-MhaDNLIUpkpQasYP_hs%2F-Mho_PCGHjtZUrL9zEFG%2F-MhohP0rcYtALUMlL8RD%2FScreen%20Shot%202021-08-23%20at%204.30.21%20PM.png?alt=media\&token=4bff79f1-53d1-45b5-977e-28c4576b57c9)

### Go to the Notifications page

Click on `Notifications`.

### Add a channel

Under `Your team's notification channels`, click `Add notification channel`.[<br>](https://docs.tryfabric.com/notifications/personal-dm-notifications)

![Click "Add notification channel" at the bottom.](https://gblobscdn.gitbook.com/assets%2F-MhaDNLIUpkpQasYP_hs%2F-MjBVT2X1P-3AKry_GLk%2F-MjBWhsjOebCU1NPzYVC%2FScreen%20Shot%202021-09-09%20at%205.46.29%20PM.png?alt=media\&token=4e701111-b080-42ca-9f70-36a0d609a632)

Choose your GitHub repository, the channel you want to connect, and the `interactive feed of new issues` option. This option lets you easily edit the issue when it comes in.

![Add your repository, channel, and select the "interactive" option.](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/EMK4eEILeHzksgUrBWz8/CleanShot%202021-10-07%20at%2018.30.44@2x.png)

You can leave the label filters blank if you want all issues to come into your channel.

Click `Create` and your notification setting will be saved.

![Fabric saves your notification setting for the Slack channel. ](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/nP0vgF32CRMD9Kmj4Nhs/Screen%20Shot%202021-10-07%20at%206.33.24%20PM.png)

Fabric also sends a message to the channel confirming your notifications have been set up.

![#feed-notification-github-action will now receive notifications for new issues.](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/DaX3ALy2P21BWAUAG0cG/Screen%20Shot%202021-10-07%20at%206.36.03%20PM.png)

That's it!