GitHub Importer

Import issues from your Github repository into Plane.

​

GitHub Importer

With Plane’s GitHub importer, importing issues from a selected GitHub repository to a chosen project on Plane is just a few clicks away.

This effortless process allows you to conveniently plan and adopt issues into your internal team by utilizing the powerful features of Cycles, Modules, and other tools available on Plane.

​

What will be Importing?

We’ll map the following fields in GitHub Issues to these fields in Plane:

​

Instructions to use GitHub Importer

​

Integrate GitHub on your Workspace

All the importers are managed under Workspace settings, to use the GitHub importer the first step is to navigate to Workspace Settings > Integrations.

To begin, click on the Add Installation button. This will prompt you to authorize your GitHub account. You can choose to grant full permission or select specific organizations based on the issues you want to import from.

After, integrating GitHub onto your Workspace, you’ll see the integration status saying Installed.

​

Starting the Import

After integrating GitHub to your Workspace, navigate to the Import/Export tab in the workspace settings. Here, you should see a message indicating a successful connection status under the Configure tab.

​

Choose the GitHub repository and the Plane project

The next step is to select the GitHub repository from which you want to import issues, as well as the Plane project to which you want to import them. Finally, toggle the Sync Issues option to perform a final check.

​

Verify the Details

During this step, you will be able to see the number of issues, labels, and users that are being imported from the GitHub repository onto the Plane project.

​

Map the users from GitHub to Plane

While importing, you have the option to map users from GitHub to Plane, or choose not to do so. We provide you with three options:

• Map to existing users
• Invite by email if the user is not already on Plane
• Do not import users

​

Confirm, Import and Refresh

The final step is to hit Confirm in order to import your GitHub data onto Plane. The import process may take anywhere from 1 to 5 minutes depending on the number of issues in the GitHub repository.

​

Verifying your Imports

When you navigate to the Plane project where you have imported the GitHub issues, you will see all the new issues from GitHub labeled as GitHub-Migrated. This label will indicate that these issues have been moved without raising conflicts with existing issues.

All the properties mentioned above, including comments, will be imported.