# FAQ

## Permissions

### Can you read my code?

**No.**&#x200C;

We don't ask for code permissions in your GitHub repositories. We do ask for access to your issue templates, which are stored in the `.github/ISSUE_TEMPLATE` folder of your repository, so we can integrate with your existing templates. We'll never push anything to these issue template files without explicit approval from someone on your team.

### Can I connect multiple GitHub orgs?

**No.** When you install Fabric on a Slack workspace, we ask you to connect one GitHub organization (not personal account).

This ensures that all your actions in the Slack workspace are scoped to that organization.

### What if I don't have a GitHub account?

**No problem!** You don't need a personal GitHub account to create issues.

There are **two types of accounts** users on your team can have: <mark style="background-color:blue;">**GitHub-linked**</mark> <mark style="background-color:blue;">**accounts**</mark><mark style="background-color:blue;">,</mark> and <mark style="background-color:orange;">**Guest**</mark> <mark style="background-color:orange;">**accounts**</mark><mark style="background-color:orange;">.</mark>

For <mark style="background-color:blue;">**GitHub-linked accounts,**</mark> users can only create issues in repositories that they have `write` permissions to.

For <mark style="background-color:orange;">**Guest accounts,**</mark> users can create issue in any repository that the admin has authorized and connected to Fabric. When a Guest account user create issues and comments in Slack, the bot will take that action and add a small note with the user's name, ex. `Created by Michelle from Slack`.

<mark style="background-color:orange;">**To sign up for a guest account,**</mark> when you're signing up for Fabric, simply click `I don't have a GitHub account`.&#x20;

{% hint style="info" %}
Note: The admin who initially sets up the GitHub integration needs a personal GitHub account. They'll need to use an organization GitHub account, and their own individual GitHub account.
{% endhint %}

## GitHub syncing

### What about issues created in GitHub?

Fabric works seamlessly with issues created either in Slack or GitHub.

#### Send issues created in GitHub to your Slack channels

When you're creating a [template](../reference/templates), you can connect an [Issue Feed](../reference/issue-feeds) channel.

Leave the `Also send issues created in GitHub` checkbox checked to send issues that match those labels to the Issue Feed as well. Your Issue Feed channel will show all new issues in the connected repository that match the label filters.

![](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/KswFIEOtDBH2Zvdc8QF6/CleanShot%202021-09-01%20at%2012.34.23@2x.png)

#### Go to your Slack channel Issue Room from GitHub

When an [Issue Room](../reference/issue-rooms) is created for an issue, we always link the channel in the description of the issue. See `Discuss in #tech-2927-update-readme-to-improve-onboarding` below.

This makes it really easy for anyone who encounters the issue in GitHub to **hop into the discussion.**

### **Do I need write permissions to a repository?**

If you have a GitHub-linked account, yes.\
\
[Read more about GitHub-linked and Guest accounts.](#what-if-a-team-member-doesnt-have-a-github-account)

### Does Fabric sync with GitHub templates?

Not currently, but we make it easy to import your current templates.

Unlike GitHub templates, Fabric templates are multi-repository, so you only have to create one template of each type.\
\
[Read more about Templates.](../reference/templates)

### How do I export my Fabric templates to GitHub?

First, go to your Fabric Dashboard.

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.

![Find Fabric in the Slack sidebar or search for it in the Fabric search bar.](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/7W03s3tZ7rjcSWVWZujm/Screen%20Shot%202021-08-23%20at%204.30.14%20PM.png)

Click on `Templates`.

Next to the template you'd like to export, click `Export to GitHub`.

![Click "Export to GitHub"](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/7h5jCqLDW8dR1D2t8vCL/Screen%20Shot%202022-05-31%20at%2012.26.29%20PM.png)

You'll see instructions on adding this template to your GitHub repository.

![](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/pk8GWHmdYovWRz6rFDio/Screen%20Shot%202022-05-31%20at%2012.26.39%20PM.png)

## Getting started

### How do I invite my team?

Go to your **Fabric Dashboard** in the Slack sidebar, and click `Invite teammates`.

### How do I sign up on my team?

First, go to your Fabric Dashboard.

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.

![Find Fabric in the Slack sidebar or search for it in the Fabric search bar.](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/7W03s3tZ7rjcSWVWZujm/Screen%20Shot%202021-08-23%20at%204.30.14%20PM.png)

If you're not signed up on Fabric, you'll see a prompt to sign up.

![](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/lYv3EJiJMbQRXdZ36G7w/Screen%20Shot%202021-09-14%20at%2011.13.03%20AM.png)

Click on `Link GitHub account` or `I don't have a GitHub account`.

When you click `Link GitHub account`, you'll be prompted to authorize your personal GitHub account, so Fabric can create issues attributed to you.

![](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/wYpOhQH5W8tIfA33qy4S/Screen%20Shot%202021-09-14%20at%2011.21.13%20AM.png)



## General

### How do I add images to an issue?

Right now, there are 4 ways to add images.

1. **Before you create the issue,** you can send a message with images in it, hover over the message, click on the three dots, and choose "create issue". See [creating an issue from an existing message.](../../reference/issues#from-an-existing-message)
2. **After the issue is created,** you can click the `Add image 🖼` button on the issue message and drop the image in the thread.
3. **After the issue is created,** you can open the thread :thread:and type your message and an image, prefaced with `add`.
4. **After the issue is created,** if you click the `Create Issue Room 🛋` button on the issue message to create a channel, you can use the `add` command to add images to the body.

{% embed url="https://www.youtube.com/watch?v=ET96UfJKdWI" %}
Method #3: Adding images in the thread using the `add` command.
{% endembed %}

### How do I create an issue?

Right now, there are 4 ways to create issues.

1. **With a slash command,** you can type `/issue`.
2. **From an existing message by clicking on the three dots.**
3. **From an existing message by reacting with the 🆕 emoji.**
4. **From the Fabric dashboard in Slack**.

#### With a slash command

To create an issue, type in the `/issue` command in the compose message box of any Slack channel or DM.

![](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/NaOY5PcbQN3nW8sdsC6P/CleanShot%202021-08-19%20at%2014.15.28.gif)

You can enter a title, like `/issue Allow users to change their email`.

![](https://downloads.intercomcdn.com/i/o/283788352/e731691da68209521ea8e84b/image.png?expires=1620536400\&signature=35d986d151444b4d643fdbae94bc835e0005d5b81d558f7f92a6fc8d5063ae5b)

#### **From an existing message**

To create an issue from a message, hover over the message and select the three-dot button.

When the menu expands, click `Create an issue`.

![Click "Create an issue...". You may have to click "More message shortcuts" the first time.](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/q8PdyJ8tc02NnaLOd8u3/Screen%20Shot%202021-08-24%20at%2012.01.27%20PM.png)

#### **Using the 🆕 emoji reaction**

To create issues even faster, you can react on a message with the 🆕 emoji!

> Note: The Fabric bot can only listen to emoji reactions in channels it's invited to. To invite the bot to a channel, type the `/invite @Fabric` slash command in a channel.
>
> ![](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/Xm5jFww72ibc4Zj767Vt/CleanShot%202022-01-20%20at%2016.13.15.gif)

This is great for quickly converting multiple messages at once into issues.

![](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/zOkrALJjn91IGKW9QE6b/Screen%20Shot%202021-08-24%20at%2012.08.14%20PM.png)

Once you create the issue, Fabric will link to your new issue in the thread, making it really easy to see where your issue went.

{% hint style="info" %}
**Pro Tip:** Go to [slack.com/customize/emoji](http://slack.com/customize/emoji) and add the 🆕 emoji as a one-click reaction for your team, to make issue creation even faster.
{% endhint %}

#### From the dashboard

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.

![Find Fabric in the Slack sidebar or search for it in the Fabric search bar.](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/7W03s3tZ7rjcSWVWZujm/Screen%20Shot%202021-08-23%20at%204.30.14%20PM.png)

#### From the dashboard: on the main page

Click `Create an issue` on the main page to create an issue.

![](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/rXXfImQPh7QuKFleZIy2/Screen%20Shot%202021-09-22%20at%2010.34.40%20PM.png)

#### From the dashboard: on the templates page

To create an issue directly from a template, click on `Templates`, click the three dots (`...`) next to your template, and choose `Create an issue`.

![](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/CVUt5hVGYqNZq11Uzm5r/Screen%20Shot%202021-09-22%20at%2010.35.44%20PM.png)

![](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/hgcPXXyREZnvxJxHuz3A/CleanShot%202021-09-22%20at%2022.39.24@2x.png)

### How do I direct issues to a channel?

You can set a team-wide default Slack channel in your settings.

When a teammate creates an issue in Slack, it will go to the specified channel by default.

![If you choose #fabric-issues as your team-wide default channel, new issues will go to this channel.](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/7pffEbUo415k92leyNDx/CleanShot%202022-01-30%20at%2017.29.24@2x.png)

If the issue is being created with a template, the issue will be sent to the channel connected to the template. If there's no channel connected to the template, the issue will go to the team-wide default channels.

![If your template has a channel connected to it, new issues will go to that channel.](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/hI1z5bLoMzfaOFONWzqu/CleanShot%202022-01-30%20at%2017.29.55@2x.png)

{% embed url="https://www.youtube.com/watch?v=NmzsG0p1tHs" %}
Setting a team-wide default channel.
{% endembed %}

[Set a team-wide default channel in your settings in your dashboard.](../team-settings#default-issue-channel)

[Set template default channels on your Templates page in your dashboard.](../reference/templates)

### Do Issue Rooms scale?

\
**Absolutely.** Some of our customers have 100s of active Issue Room channels.

Fabric cleans up channels for you by archivesing Issue Rooms when issues close.

With Slack channels, unless you've joined, you won't get notified about updates on a channel, and it won't show up in your sidebar. You can also mute any channel that you are a member of.‌

## Troubleshooting

### The emoji reaction isn't working

The :new: [reaction for creating issues](../../reference/issues#using-the-emoji-reaction) only works in channels that the Fabric bot is invited to, for privacy reasons.\
\
To invite the Fabric bot to the channel, type `/invite @Fabric`.

![](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/bbGnTz6oqZ1U2qY9PXS0/CleanShot%202022-01-20%20at%2016.13.15.gif)



We recommend doing this for all channels you'd like to use Fabric in.

### I changed my GitHub org name

First, you want to unlink your installation from GitHub, and then relink your new installation.

#### Step One: Unlink your installation from GitHub

To uninstall from your GitHub organization, go to your organization and click `Settings`.

![Click the "Settings" tab on your GitHub organization page.](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/8Nzrf1PQptiXWJ8oeDuL/Screen%20Shot%202021-10-05%20at%2012.56.56%20PM.png)

Click `Configure` next to the Fabric app.

![Click "Configure" next to "Fabric for GitHub".](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/sxWJvFy3AYDRC49LSnug/Screen%20Shot%202021-10-05%20at%2012.57.19%20PM.png)

Scroll to the bottom of the page and click `Uninstall`.

![Click "Uninstall" at the bottom of the page.](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/58UbIQieg73B3yGW2E1U/Screen%20Shot%202021-10-05%20at%2012.57.33%20PM.png)

This will remove the GitHub organization authorizations, as well as any personal authorizations tied to your GitHub organization.

#### Step two: Relink your installation

Then, go to your Fabric Dashboard.

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.

![Find Fabric in the Slack sidebar or search for it in the Fabric search bar.](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/7W03s3tZ7rjcSWVWZujm/Screen%20Shot%202021-08-23%20at%204.30.14%20PM.png)

Follow the prompts to connect your new GitHub organization.

![](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/wYpOhQH5W8tIfA33qy4S/Screen%20Shot%202021-09-14%20at%2011.21.13%20AM.png)

### My Fabric Slack App got unlinked

To reinstall your Fabric Slack App, go to `app.tryfabric.com/onboarding`.

![](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/L9oSm57SGhpJdxLykqyY/Screen%20Shot%202021-09-14%20at%2012.26.39%20PM.png)

Select your Slack workspace to install.

![](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/acdR7p6ao67OPFbQ4rIl/Screen%20Shot%202021-09-14%20at%2012.28.01%20PM.png)

Next, follow the prompts to connect GitHub.

![](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/hRJuExk8k70PnQV5aehf/Screen%20Shot%202021-09-14%20at%2012.28.09%20PM.png)

If you have any further questions, email us at support@tryfabric.com.

### How do I switch accounts?

If you want to switch the account that Fabric uses to create issues on your behalf, first go to GitHub, click your profile picture in the top right corner, and click `Settings`.

![](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/wtW3uoarb1t8DXZERw8o/Screen%20Shot%202021-09-22%20at%208.25.00%20PM.png)

Next, click `Application` on the sidebar, and `Authorized GitHub Apps`.

![](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/qumizvaucumKllcb1w12/Screen%20Shot%202021-09-22%20at%208.35.34%20PM.png)

Click `Revoke` and then go to your Fabric Dashboard in Slack.

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.

![Find Fabric in the Slack sidebar or search for it in the Fabric search bar.](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/7W03s3tZ7rjcSWVWZujm/Screen%20Shot%202021-08-23%20at%204.30.14%20PM.png)

There, you'll see a prompt to connect your personal account again.

![](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/lYv3EJiJMbQRXdZ36G7w/Screen%20Shot%202021-09-14%20at%2011.13.03%20AM.png)

Click on `Link GitHub account` or `I don't have a GitHub account`.

When you click `Link GitHub account`, you'll be prompted to authorize your personal GitHub account, so Fabric can create issues attributed to you.

![](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/wYpOhQH5W8tIfA33qy4S/Screen%20Shot%202021-09-14%20at%2011.21.13%20AM.png)

### How do I create an issue in a repository I don't have access to?

If you're not able to create an issue in a repository with Fabric, you may not have the right GitHub permissions. You'll need `write` permissions on the repo.

**Ask your admin for `write` access to the repository.** [This article](https://docs.github.com/en/organizations/managing-access-to-your-organizations-repositories/repository-permission-levels-for-an-organization) explains GitHub's permission model.

![Accept the invitation from your admin to create issues in the repository.](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/hWio7ultqYF3DhTDdsXp/Screen%20Shot%202021-09-23%20at%201.12.05%20PM.png)

Keep in mind you may have to **accept the repository invitation** to have access. GitHub should send you an email with a link to accept.

### How do I change my Slack and GitHub installations?

#### Uninstall from Slack

To uninstall from Slack, go to your Fabric app in Slack.

Click on the `App` tab and click `Configuration`.

![Click on "Configuration".](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/VXicZHawEM38VkVjKKzU/Screen%20Shot%202021-10-05%20at%2012.53.41%20PM.png)

At the bottom of the next page, click `Remove App`.

![Click "Remove App".](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/rpJp5qKIfB6nY1wQe0qF/Screen%20Shot%202021-10-05%20at%2012.54.12%20PM.png)

#### Uninstall from GitHub

To uninstall from your GitHub organization, go to your organization and click `Settings`.

![Click the "Settings" tab on your GitHub organization page.](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/8Nzrf1PQptiXWJ8oeDuL/Screen%20Shot%202021-10-05%20at%2012.56.56%20PM.png)

Click `Configure` next to the Fabric app.

![Click "Configure" next to "Fabric for GitHub".](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/sxWJvFy3AYDRC49LSnug/Screen%20Shot%202021-10-05%20at%2012.57.19%20PM.png)

Scroll to the bottom of the page and click `Uninstall`.

![Click "Uninstall" at the bottom of the page.](https://content.gitbook.com/content/D1GCmv3PztplZI6PqlYq/blobs/58UbIQieg73B3yGW2E1U/Screen%20Shot%202021-10-05%20at%2012.57.33%20PM.png)

This will remove the GitHub organization authorizations, as well as any personal authorizations tied to your GitHub organization.

#### Reinstall on Slack and GitHub

[Follow the directions here](https://docs.tryfabric.com/admins/faq#my-fabric-slack-app-got-unlinked) to reinstall.

## Support

To give feedback or ask questions, email us at support@tryfabric.com.

You can also tweet at or DM us on the [Fabric Twitter. ](https://twitter.com/tryfabric)
