Guide
How to set up GitHub integration and connect Pull Requests to real work.
GitHub integration allows to import Repositories, Branches, Projects and Pull Requests into Fibery. The most interesting case is to import Pull Requests and attach them to real work items, like Features, User Stories, or Tasks. Thus you will see Pull Requests statuses right in Fibery.
Noted: commits from primary branch are synced only
Setup GitHub sync
Navigate to Templates and find GitHub template
Click Sync.
Authorize the GitHub app.
Choose what databases you want to sync from GitHub. Specify starting date for the sync, by default it is a month ago, but you may want to fetch all the data:
Click Sync now and wait. GitHub Space will appear in the sidebar and all the data should be synced eventually.
About Projects
We exclusively support GitHub Projects V2.
Note: "Projects Classic" (Legacy) at the Repository, User, or Org level is not supported.
To simplify cross-project reporting, the integration uses a Single Database approach:
All items from all selected GitHub projects are synced into one "GitHub Project Item" database.
Custom fields from different projects are merged into this single database.
If multiple projects use the same field name with different meanings, the integration will append a suffix (e.g., Effort 1, Effort 2) to ensure data integrity.
Link Pull Requests to User Stories (or any other Databases)
We will use Auto-linking (Set Relations Automatically) feature to link Pull Requests with User Stories in this example.
To have these connections, you have to encode User Story Id in your Pull Requests. In our team we include User Story Id into a Pull Requests name, like this:
fibery/us#2189 add support date box filter
The main idea is to extract User Story Id from Pull Request name and link User Story and Pull Request Databases via automatic rule. This is a two-step process.
Step 1. Create User Story Id formula field inside Pull Request
Open any Pull Request and add a new formula field named User Story Id, in our case formula will look like this:
If(
StartsWith(Name, "fibery/us#"),
Trim(ReplaceRegex(Name, "fibery\/us#(\d+).+", "\1 ")),
""
)
Step 2. Create an automatic connection between Pull Request and User Story
Inside a Pull Request create a new Relation field, set relation to User Story and set automatic rule to match any Pull Request with a User Story by Id:
As a result, you will see a list of Pull Requests inside User Stories, like this:
GitHub Actions
When something happens in Fibery (ex. a Story is completed), update GitHub.
Here is a list of possible actions:
You may create either rule or automation button.
And then you have to connect your Github account.
Why can I see my GitHub repositories in the left menu, but not when using my custom action button or rule?
The repositories you see in the left menu are part of your GitHub integration, while the repositories shown (or not shown) in your custom action popup are not automatically connected to that integration.
If a repository field appears in the action popup, it's usually just a plain text box — unless it's specifically configured to fetch or link real data. So even if you can see repos elsewhere in Fibery, they won’t show up in your custom action unless you've set that up manually.
FAQ
How do I authenticate Fibery with GitHub securely?
Fibery uses OAuth or personal access tokens with the necessary scopes for reading branches, PRs, and commits. Permissions are managed via GitHub, and Fibery requests only the needed scopes for the integration to function.
What permissions do I need on a GitHub side?
Here are they:
Make sure permissions are granted to Fibery
What if the User, that configured the integration is not a part of the Fibery team anymore?
When the synchronization owner becomes inactive (in Fibery), your integration will show you an error. Someone should provide his/her account on the configuration screen (take over ownership).
Synchronization should be reconfigured. Someone should press edit settings and use his/her account and only afterward press Full sync.
How to reconfigure Fibery integration permission on GitHub?
To reconfigure the permissions, go to the https://github.com/settings/applications page and click on the Fibery integration, where you can make changes to the permission settings.
How to sync documents from Fibery to Github?
This can be done by creating a custom script. You can check this community topic for details & examples.
How do I handle multiple GitHub repositories or accounts syncing into Fibery?
Syncing multiple repositories/accounts is supported, but may require setup per account. You can use automation rules to link related entities across different repositories. Each GitHub account creates separate databases, but you can relate them through Fibery's flexible data model.
How can I quickly link to GitHub PRs from Fibery documents?
In GitHub I can just type #34 and it links to the PR. In Fibery, finding the right PR feels slower — I need to browse into the GitHub space, then the PR database, then look up the ID. Is there a quicker way?
At the moment, Fibery doesn’t provide a built-in “shortlink” trigger like #34. However, there’s a simple workaround that makes referencing much easier:
Go to your GitHub PR database in Fibery.
Set the PR Number field as the Name field.
Now, when writing in a document, you can type #34 and Fibery’s entity mention search will immediately suggest the PR with that number.
This keeps your workflow close to GitHub’s native referencing, while still linking to the full PR entity in Fibery.