Bitbucket Integration

Efficient website feedback with Bitbucket in a few simple steps.

Joe Scanlon avatar
Written by Joe Scanlon
Updated over a week ago

Collect website feedback as new issues directly in your Bitbucket projects.

Set up a Bitbucket Integration

Enable an issue tracker on your Bitbucket account

  1. From a repository, select Repository settings.

  2. Select Issue Tracker under Issues on the left sidebar.

  3. Check the option for either a Private issue tracker or a Public issue tracker. The system saves your selection, and the Issue Tracker item appears in the repository's menu bar.

Add a project

To get started, go to the dashboard and Create a project.

Complete the project form by entering a :

  • Project name

  • The website where you wish to collect feedback

  • Select your integration

  • Select the space within your integration where you wish to receive your feedback

If this is your first time connecting, you must authorize to use your Bitbucket account.

Configure forms

We fetch your native Bitbucket fields into your widget form. You can show/hide any fields and preset fields. For example, set the Type as Bug and allow your reporters to change it where needed.

Note: members report through the Member form, while Guests and Public Reporters report via the Guest form. More on that in our User Roles Guide.

Install widget

The last step is to install the website widget. We have many options for installing our widget and recommend our manual JavaScript install in most cases.

Alternatively, install the widget via the WordPress plugin, NPM package, or send a request to your developer in one click.

Visit your website, refresh and check that the widget appears.

How it works

Collect feedback

Reporters can submit feedback directly to your Bitbucket project without leaving their website. Their feedback will automatically include detail-rich technical data.

Let’s say the Contact Us button is broken on the About Us page. The reporter clicks on the widget and is presented with a screenshot and a feedback form to complete.

The screenshot can be annotated, and the feedback form can be as simple or as complex as you wish. We recommend keeping the feedback form as simple as possible for your non-technical reporters.

Review issues

In your Bitbucket project, you see the feedback arrive with the screenshot and automatically captured technical data, including:

  • Page URL

  • Browser

  • Screen size

  • Operating system

Communicate with reporters

The "Contact via" link opens the Feedback Page, where you can communicate with your reporters. All conversations will be synced with Bitbucket.

Synchronize Status

Status Sync is not currently available on our Bitbucket Integration. Please consider voting on that feature request here if you would like our team to build this out.

Adding a vote and some commentary will help convince our team to build out this feature. 🙏


Is secure?

We take your data and the security of our systems very seriously, using the most advanced security to connect with your account. See the latest version of our security policy at:

What permissions are required to integrate with Bitbucket?

Admin permissions are required on the Bitbucket project you wish to connect with.

I can't connect my Bitbucket account to

Any issues setting this up? Try the following:

  1. Log in to your Bitbucket account

    Log in to Bitbucket in a second tab. This ensures that your password and username do not require additional security verification. When logged in to Bitbucket, return to and try connecting your Bitbucket account.

  2. Reset your password in Bitbucket

    Try setting a new password in your Bitbucket account and see if that helps to resolve the issue.

  3. Still not working?

    Please start a chat conversation with us in the lower right corner of your screen.

I can't find my Bitbucket repository in

if you cannot locate your Bitbucket repo, it may be for one of the following two reasons:

  1. The issue tracker is not activated in your repository

    By default, Bitbucket does not activate the issue tracker for repositories.

    • From a repository, select Repository settings.

    • Select Issue tracker under Issues on the left sidebar.

    • Check the option for either a Private issue tracker or a Public issue tracker.

    • The system saves your selection, and the Issue Tracker item appears in the repository's menu bar.

  2. You have read-only access to the repository.

    Since all repositories listed in are associated with your Bitbucket account, you need to ensure that you are a contributor. Contributors are either owners, admin, or have write access. If you have read-only access on some repositories, Marker will note show those repos.

Invite your team to collaborate on a dedicated Bitbucket project today with, where anyone can report bugs and feedback in seconds. We have many advanced features for you to explore. See Academy, which we continuously update with our latest features.

Did this answer your question?