All articles

Wrike and Bitbucket Sync: Overview

Overview

Note

The Wrike and Bitbucket 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 Bitbucket sync is part of the Wrike Sync add-on. It enables automatic updates between Wrike tasks and Bitbucket. Once you select a Bitbucket repository that you'd like to sync with Wrike:

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

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

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

Note

The Wrike and Bitbucket two-way sync works with Bitbucket.com. Because of API limitations, we're unable to support on-premise installations of Bitbucket.

Once the sync is done, Wrike tasks become linked with corresponding Bitbucket 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.

Tip

This page goes over how the sync works and what you can do after it's in place. To learn more about setting up the sync, please see Wrike and Bitbucket 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 Bitbucket data and build consolidated timelines, workload views, and dashboards that combine Wrike and Bitbucket 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 Bitbucket, 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.

  • Sync attachments (depending on your settings).

  • Add, remove, or change assignees.

Note

Users can only be added as assignees in Wrike or Bitbucket 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 Bitbucket, then they won’t be assigned to the corresponding Bitbucket issue.

You can find more details on how fields are mapped between Bitbucket and Wrike below.

Create Bitbucket issues from Wrike

There are two ways to create Bitbucket issues from Wrike:

  1. Open the synced Wrike folder (the folder where Bitbucket 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) will be created in the synced Bitbucket repository within five minutes.

Subtasks and the Bitbucket integration

Default settings

Once a Bitbucket issue is added to Wrike as a task, then you can convert the Wrike task into a subtask. Convert the synced task into a subtask of another synced task or add it as a subtask in a related, but non-synced, project. In either case, when you convert a synced task into a subtask:

  • Only the Wrike organizational structure is affected. In Bitbucket, the issue remains an issue and isn't converted into a subtask.

  • The Wrike subtask remains synced with the Bitbucket issue and the synced fields will continue to automatically update.

Syncing subtasks

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

Mapped and unmapped fields

Mapped 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

Bitbucket

Title

Summary

Description

Description

Status

Status

Comments

Comments

File attachments

File attachments

Assignees

Assignees

Note

Users can only be added as assignees in Wrike or Bitbucket if they have a user license in that tool. If a user has both a Wrike and Bitbucket 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 Bitbucket account, but they use different emails with each tool, then you need to manually map their accounts.

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