With Marker.io, you can send website feedback directly to your Bitbucket projects. Follow these steps to get set up quickly.
Enable Bitbucket Issue Tracking
Before connecting Marker.io, ensure your Bitbucket repository has an issue tracker enabled:
Open your Bitbucket repository.
Click on Repository settings.
In the left menu, select Issue Tracker.
Choose Private or Public issue tracker and save your selection.
You’ll now see an Issues tab in your repository menu.
Create a Marker.io Project
Now, set up your project in Marker.io to start collecting feedback:
Go to the Marker.io dashboard and click Create a project.
Fill out the form with:
Project name
Website URL (where feedback will be collected)
Integration (select Bitbucket)
Repository (where feedback should be sent)
If this is your first time, authorize Marker.io to access your Bitbucket account.
Configure forms
Marker.io pulls your Bitbucket issue fields into the widget form. You can:
Show or hide fields.
Pre-fill fields (e.g., set issue type as Bug).
Allow reporters to edit fields if needed.
🔹 Note:
Members report through the Member Form.
Guests & Public Reporters use the Guest Form.
Learn more in our User Roles Guide.
Install the Marker.io Widget
To collect feedback on your website, install the Marker.io widget:
Installation Options:
Manual JavaScript install (Recommended)
WordPress plugin
NPM package
Send install request to your developer (1-click option)
See all available instalation options here
Once installed, refresh your website to check if the widget appears.
How it works
Collect feedback
Reporters can submit feedback directly from your website to your Bitbucket project. Each report includes:
✔️ A screenshot (with annotation tools)
✔️ A feedback form
✔️ Technical details (e.g., browser, OS, screen size, page URL)
For example, if the "Contact Us" button on the About Us page isn’t working, a reporter can:
Click the button.
Capture a screenshot.
Fill out the feedback form.
Submit the issue to Bitbucket.
Review Issues in Bitbucket
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
Click the "Contact via Marker.io" link in Bitbucket to open the Feedback Page and reply to reporters. All conversations sync with Bitbucket.
Status Synchronization
Currently, Bitbucket does not support status sync with Marker.io.
Want this feature? Vote for it here.
FAQs
Is Marker.io 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: https://marker.io/security.
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 Marker.io
Try these steps:
Log into Bitbucket in a second browser tab.
Retry connecting Marker.io to Bitbucket.
Reset your Bitbucket password if needed.
Still stuck? Start a chat with us in the bottom-right corner of the page.
Can’t find your Bitbucket repository in Marker.io?
Possible reasons:
Issue tracker is disabled. (See step 1. above)
You have read-only access. Marker.io only shows repositories where you have write/admin access.
Need Help?
If you have any questions, comments, or corrections, chat with us at the bottom right of our web pages.