All articles

Wrike and GitHub Sync: Overview

Overview

Note

The Wrike and GitHub two-way sync is powered by a partner: Unito.io. For more information on how the two-way sync works, please check out Unito’s Help Center.

The Wrike and GitHub sync is part of the Wrike Sync add-on. It enables automatic updates between Wrike tasks and GitHub issues. Select a GitHub repository that you'd like to sync with Wrike and:

  • A new folder is created in Wrike (this folder is linked with the GitHub repository).

  • A task is created in Wrike for each issue in the GitHub repository.

  • For any task created in or added to the synced folder, a GitHub issue is created in the synced repository.

Note

The Wrike and GitHub two-way sync works with GitHub.com and GitHub Enterprise.

The sync doesn't currently work with GitHub Projects.

Once the sync is done, Wrike tasks are linked with corresponding GitHub issues, and when you update a linked task, the linked issue is automatically updated as well (and vice versa). Your teams can collaborate effectively while remaining in the tool that they’re most familiar with.

Individual team members need only a Wrike or GitHub license for the sync to work. They don't need licenses in both tools. For example, if someone updates a task in Wrike, the GitHub issue is automatically updated even if the user doesn't have a GitHub license.

Tip

This page goes over how the sync works and what you can do once the sync is in place. To learn more about setting up the sync, please see Wrike and GitHub Sync: Setup Guide.

Use cases

  • Project management: Project and product managers can coordinate projects across both tools and keep an eye on how projects are progressing.

  • Team collaboration: Non-technical employees and developers can easily track project progress, answer questions, and share information.

  • Reporting and timelines: Use Wrike to report on GitHub data and build consolidated timelines, workload views, and dashboards that combine Wrike and GitHub information.

Ongoing sync: Update time and synced actions

Update time

After you set up a sync, if a change is made to a synced item in Wrike or GitHub, then the corresponding task or issue in the other tool is updated within five minutes.

Synced actions

Make any of the below updates in one tool and the corresponding update automatically occurs in the other tool:

  • Create tasks or issues.

  • Change a task or issue’s status (including closing or completing the task or issue).

  • Update the title or description.

  • Add comments (comments are always synced, but the name of the person who made the comment is only synced if that person has an account in both tools).

  • Sync attachments (depending on sync settings).

  • Add, remove, or change assignees.

Note

Users can only be added as assignees in Wrike or GitHub if they have a user license in that tool. For example, if a user is assigned to a synced Wrike task, but they don’t have a user license in GitHub, then they won’t be assigned to the corresponding GitHub issue.

More details on how fields are mapped between GitHub and Wrike can be found below.

Create GitHub issues from Wrike

There are two ways to create GitHub issues from Wrike:

  1. Open the synced Wrike folder (the folder where GitHub issues are added) and create a task in that folder.

  2. Open an existing task and tag the task in the synced Wrike folder.

An issue (based on the task) is created in the synced GitHub repository within five minutes.

Subtasks and the GitHub integration

GitHub doesn't have subtasks so you won't be able to sync them.

Mapped and unmapped fields

The below fields are synced by default. Please check Unito’s Help Center for more details on customizing which fields are synced and how.

Wrike

GitHub

Title

Summary

Description

Description

Status

Status

Comments

Comments

Assignees

Assignees

File attachments

File attachments

Note

Users can only be added as assignees in Wrike or GitHub if they have a user license in that tool. If a user has both a Wrike and GitHub account, and they use the same email with both tools, then when they're assigned to something in one tool, they're automatically assigned to the synced item in the other tool. If a user has both a Wrike and GitHub account, but they use different emails with each tool, then you need to manually map their accounts.

Manually mapped fields

You can manually map fields in your sync settings.

Unmapped fields

If a field you'd like to sync isn't listed, please contact Unito. They may support it through a manual configuration.

Top