Cycle's help center
LegalCompany
  • 🚀Get started
    • 🤔What is Cycle? [Start here]
    • 📥Centralize feedback
    • 💡Extract insights from feedback
    • 🌱Document features in your roadmap
    • 📡Write your release notes and close the loop
  • 💪Core concepts
    • 🏡Home
    • 📥Feedback
    • 💡Insights
    • ⛰️Roadmap
    • 🔊Releases
    • 🤩Closing the loop
    • ⚡Cycle AI
    • 📊Customer voice dashboards
  • ⚙️Setup
    • 🔌Integrations
      • Slack
      • Linear
      • Intercom
      • Zendesk
      • Salesforce
      • Gong
      • HubSpot
      • Zapier
      • Chrome extension
      • Figma, Loom, Miro & Pitch
      • Email
      • Notion
      • GitHub
      • Modjo
    • Product areas
    • 📋Views
    • 🏷️Properties
    • 👱Customers
    • 🎭Manage workspace members
    • 🔔Notifications
    • 🔀Statuses
    • ✏️Collaborative, rich markdown and AI-powered editor
    • 🔓Security
  • 🚲Advanced
    • 🎉Public changelog
    • 🤖AI & automations
    • 📹Call recording
    • 📚Content templates
    • 🏔️Advanced Roadmaps and custom views
    • ⚒️Multiple doc types
    • 🔍Search
    • 🏆Pro Cycler tips shortlist
    • ⌨️Keyboard shortcuts
  • 🔐SAML/SSO
  • 👨‍🏫Cycle University
    • 👁️Best practices for views
    • 🏎️Fast-track your onboarding
    • 🐞Bug handling with Cycle
    • 💻API
      • ⚡Webhook event for all properties changes
      • 🔗How to integrate with Jira Product Discovery
    • ❓FAQ
  • 🤔Guides
    • ⬇️Migrate your data to Cycle
      • Canny migration
    • 📖Glossary
    • Synchronise your customer data
  • How to
    • Page 1
Powered by GitBook
On this page
  • Installation
  • How to use it
  • Mention existing GitHub issues in Cyle docs
  • Editing a GitHub issue
  • Create (multiple) GitHub issue(s)
  • Coming soon 👀
  • FAQ

Was this helpful?

  1. Setup
  2. Integrations

GitHub

Mention GitHub issues in Cycle docs, create issues in bulk and update their status without switching tools.

PreviousNotionNextModjo

Last updated 1 year ago

Was this helpful?

Looking to connect product delivery and discovery? You're in the right place. Here's everything you need to know about integrating GitHub issues with Cycle.

Installation

Follow these steps or click the interactive step-by-step tutorial below 👇

  1. Open your Cycle workspace settings and scroll down to "Integrations"

  2. On the right, next to "Collaboration," click on "Add new" and select "GitHub issues"

  3. Log in to your GitHub account and select your repository

  4. Copy the URL of the GitHub project you want to sync with Cycle and paste it under the GitHub issues integration card

The GitHub repository must belong to a GitHub organization. Only organization owners can set up this integration. You can have multiple Github projects linked.

How to use it

Mention existing GitHub issues in Cyle docs

Since you added the GitHub integration, you probably have existing issues over there that aren't tied to a product requirement document (PRD).

No worries, you can easily mention existing GitHub issues in Cycle using the "/GitHub issue" command.

This will also add a comment in GitHub with a link to the corresponding Cycle doc so you can easily have everyone on the same page.

Editing a GitHub issue

To edit a mentioned issue, click the down-facing arrow to the left of the GitHub issue to expand it. From here, you can edit its status. Every edit, no matter which tool it was made from, is safely synced in GitHub and Cycle at all times.

Create (multiple) GitHub issue(s)

To create a single GitHub issue, highlight any text in a Cycle doc and click on the GitHub icon in the toolbar. You can also use the keyboard shortcut "⌘+2".

To create multiple issues at once, highlight a bullet list of issues to create, and use the GitHub icon in the toolbar or the keyboard shortcut, ⌘+3.

Note: Creating GitHub issues in bulk will only work on bullet lists.

Coming soon 👀

Once all GitHub issues in a Cycle doc have been set as "Done", Cycle will automatically update the doc's status so that customer-facing teams know they can close the feedback loop.

FAQ

I'm getting an error when I try to create multiple GitHub issues at once

Select the bullet list with the issues you want to create. In the toolbar, click on the "format as bullet list" icon. Now try creating the GitHub issues again.

⚙️
🔌
Mention existing GitHub issues
Edit a GitHub issue from Cycle
Create GitHub issues in bulk