Skip to main content
Skip table of contents

GitHub for Miro

GitHub for Miro will enable you to integrate both platforms and streamline your workflows. By leveraging the strengths of these apps in a cohesive working space, you’ll be able to improve efficiency and collaboration.

Key features

GitHub for Miro allows you to:

  • Convert Miro sticky notes into GitHub issues using app cards.

  • Import issues from GitHub and place them in Miro as app cards.

Installing GitHub for Miro

Any user can install GitHub for Miro to a Miro team. However, admins can restrict non-admins from adding apps if they're on Miro's Business or Enterprise Plan. To learn more, you can check out Can non-administrators install apps?

  1. Go to Miro Marketplace and search for “GitHub for Miro”.

  2. Select the app and click Connect.

  3. Next, allow permissions for GitHub for Miro by clicking Allow.

Authorizing GitHub for Miro

  1. Open a Miro board in your team space. At the toolbar menu, search for “GitHub for Miro” and click on the icon.

  2. On the consent form, Check Yes, I understand and agree to both options and click Continue.

  3. Finally, select the GitHub account you’d like to connect to and click Save changes.

That’s it! The GitHub connection is now authorized.

Importing GitHub issues

GFM Import issues 20240611.png
  1. Click on the GitHub for Miro icon on the toolbar.

  2. Open the Create tab and click on the +Import GitHub issues button.

  3. Select the issues and click Import.

  4. The GitHub issues will now appear as Miro app cards.

    GFM App cards 20240611.png

Creating GitHub issues from Miro sticky notes

GFM Import app cards 20240611.png
  1. Create a sticky note on your Miro board and select it.

  2. Select the GitHub for Miro icon from the toolbar.

  3. If you have multiple repositories connected, select one where the issue will be created.

  4. Fill out the form with the relevant information:

    1. Repository - The repository you want to push this Miro card to.
      (info) The repositories listed in the dropdown menu will be associated with the default GitHub organization you’ve chosen when configuring the app.

    2. Issue title - The text from the Miro app card will be automatically included here.

    3. Assignees - The users you want to assign the issue to.

    4. Labels - The issue’s associated labels.

    5. Milestone - The issue’s current milestone.

    6. Description - What the issue is about.

  5. Click Convert issue to GitHub after filling out the form.

  6. The sticky note will be converted into an app card and a GitHub issue will be created in GitHub.

  7. You can visit the related GitHub issue by clicking on the link in the detailed view of the app card. To see more detailed information on the Miro app card, click the expand icon on the top right of the card.

Creating multiple GitHub issues with Miro sticky notes

  1. Create multiple sticky notes and then select them.

  2. Click the GitHub icon on the toolbar menu.

  3. If you have multiple repositories connected, select one where the issue will be created.

  4. Fill out the form with relevant information and choose your repository. Then, click Convert issue to GitHub.

  5. The sticky notes will be converted into app cards and corresponding issues will be created in GitHub.

The app cards and GitHub issues will share the same information that you’ve filled out in the form in Step 3.

Security statement

ServiceRocket is committed to the protection and security of our customers' information. Learn more about GitHub for Miro’s security practices in our security statement.

Knowledge base

Have questions? Check out our knowledge base for quick answers and helpful tips!

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.