All articles

Wrike and GitHub Sync: Overview

Wrike and GitHub Sync is a part of the paid Project Syncs add-on. Admins on Business and higher plans can create the Wrike and GitHub two-way sync.

⏱ 4 min read

Overview

The Wrike and GitHub Two-Way Sync allows automatic updates between Wrike tasks and GitHub issues. Select a GitHub repository that you would 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.

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

Please note, this page goes over how to sync tasks and issues between Wrike and GitHub , for details on how to set up syncs, please see Wrike and GitHub Two-Way Sync: Setup Guide.

Important Information

  • Individual team members need only a Wrike or GitHub license for the sync to work. They do not need licences in both tools. For example, if someone updates a task in Wrike, the GitHub issue is automatically updated even though the user does not have GitHub license.
  • The Wrike and GitHub Two-Way sync works with GitHub.com and GitHub Enterprise.
  • The Wrike and GitHub Two-Way Sync is powered by a partner: Unito.io. For even more information about how the two-way sync works, please check out Unito’s Help Center.
  • The sync does not currently work with GitHub Projects.

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 to build consolidated timelines, workload views, and dashboards that combine both Wrike & GitHub information.

Ongoing Sync: Update Time and Synced Actions

Update Time

After you setup 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:

  • Creating tasks or issues
  • Changing a task or issue’s status (including closing or completing the task or issue)
  • Updating the title or description
  • Adding 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)
  • Adding, removing or changing assignees*
  • Attachments may also be synced depending on sync settings

*Please 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 will not 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 how to customize which fields are synced and how.

Wrike

GitHub

Title

Summary

Description

Description

Status

Status

Comments

Comments

Assignees

Assignees*

File attachments

File Attachments

 

*Please 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 are assigned to something in one tool, they are 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

In addition to the fields above you can manually map:

  • Milestones (The GitHub milestone's name is added to a Wrike Custom Field, and the due date becomes the Wrike task's due date)
  • Custom Fields

Unmapped Fields

If a  field you would like to sync is not listed please contact Unito, they may support it through a manual configuration.

0 comments

Article is closed for comments.

Top