# GitHub Integration

Create GitHub issues from FeatureOS feedback, link existing issues, and keep statuses in sync with configurable two-way rules.

- Category: Development
- Provider: FeatureOS
- Website: https://github.com
- Documentation: https://help.featureos.app/en/articles/github-integration
- Story: https://featureos.com/integrations/github

Feature requests live in FeatureOS. Code lives in GitHub. Without a bridge, product managers end up copying and pasting between the two, and context gets lost along the way. The GitHub + FeatureOS integration removes that friction.

Push customer feedback to GitHub as issues. Link existing issues to feedback posts. Set up sync rules so status changes flow automatically between both tools. When your dev team closes an issue, the FeatureOS post updates and voters find out their request shipped.

## How to Connect GitHub to FeatureOS

1. In FeatureOS, go to **Dashboard > Organization Settings > Integrations > GitHub > Connect**.
2. Sign into GitHub and authorize FeatureOS. You can connect all repositories or pick specific ones. The admin running this setup needs access to all selected repos. Skip forked repositories.
3. Once authorized, you land back in FeatureOS with your connected GitHub org and profile visible.

## Automatically Push Feedback to GitHub Issues

Enable **Automatic Push to GitHub** to send FeatureOS posts to GitHub as issues based on status changes. Two trigger options:

- Push immediately after a post is submitted.
- Push after moderation approval (if you use moderation).

Pick one or more FeatureOS boards as triggers.

## Syncing Statuses Between GitHub and FeatureOS

Create rules to keep things aligned:

- When **any linked issue** changes status, update the FeatureOS post.
- When **all linked issues** change status, update the FeatureOS post. Good for requests that require multiple PRs.
- When a **FeatureOS post** changes status, update linked GitHub issues.

Updates flow both ways once saved.

## Creating and Linking GitHub Issues from FeatureOS

**Create a GitHub issue:** From any FeatureOS post, click **Push to GitHub**. Edit the title and description, select the repository, and push. A linked issue appears in GitHub immediately.

**Link an existing issue:** From a FeatureOS post, click **Link Issue** and search by title or issue ID. Links work in both directions.

**Unlink:** Remove the association from FeatureOS. The GitHub issue stays untouched.

**Manage repo access:** Change which repositories FeatureOS can see anytime in GitHub under **Settings > Applications > Configure FeatureOS**.

**Disconnect:** Go to **Organization Settings > Integrations > GitHub > Configure > Disconnect** in FeatureOS.

## How GitHub + FeatureOS Helps Each Role

Product managers track feature development from FeatureOS without switching to GitHub. Developers see customer votes and comments inside their issues. Customers get notified when their requested features ship.

## FAQ

### What is the GitHub + FeatureOS integration?

The GitHub + FeatureOS integration turns FeatureOS feedback into GitHub issues, links existing issues to posts, and syncs statuses with configurable two-way rules. When engineering closes work in GitHub, the FeatureOS post can update and voters can learn the request shipped. Product keeps the customer voice; developers stay in GitHub.

### How do I connect GitHub with FeatureOS?

In FeatureOS, open Dashboard → Organization Settings → Integrations → GitHub → Connect, authorize FeatureOS on GitHub, and choose all or specific repositories. The admin needs access to selected repos; skip forked repositories.

### Can FeatureOS posts create GitHub issues automatically?

Yes. Enable automatic push so FeatureOS posts become GitHub issues on submit or after moderation approval, for the boards you select as triggers.

### How does status sync work between GitHub and FeatureOS?

Rules can update a FeatureOS post when any linked issue changes, when all linked issues change, or update linked GitHub issues when the FeatureOS post changes status.

### Can I link an existing GitHub issue to a FeatureOS post?

Yes. From a FeatureOS post, use Link Issue and search by title or issue ID. Links work both ways; unlinking removes the association without deleting the GitHub issue.

### Which FeatureOS plan includes the GitHub integration?

The GitHub + FeatureOS integration is available on every FeatureOS plan (Starter, Growth, and Business). Your plan sets how many integrations you can enable at once: Starter includes 3, Growth 5, and Business unlimited.

### Who is the GitHub + FeatureOS integration best for?

Product and engineering teams that ship from GitHub issues and want FeatureOS feedback, votes, and status updates connected to the same work.

---

Source: https://featureos.com/integrations/github
All integrations: https://featureos.com/integrations.md
Product overview: https://featureos.com/featureos.md