Collect website feedback as new issues directly in your GitHub projects. With our 2-way synchronization, your issue status, fields, and comments are always in sync.
Set up a GitHub Integration
Add a project
To get started, go to the Marker.io 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 need to authorize marker.io to use your GitHub account.
Configure forms
We fetch your native GitHub fields into your widget form. You can show/hide any fields and preset fields. For example, set the Labels field as Bug to ensure that all new feedback gets flagged automatically as a bug.
Note: Marker.io 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 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 their feedback directly to your GitHub 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 GitHub 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 Marker.io" link opens the Feedback Page, where you can communicate with your reporters. All conversations will be synced with GitHub.
Synchronize Status
Once you update an issue status to "done" within GitHub, this will update the Marker.io status to resolved and notify the reporter via email that the issue is complete.
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 GitHub?
Admin permissions are required on the GitHub project you wish to connect with.
I can't connect my GitHub account to Marker.io
Any issues setting this up? Try the following:
Log in to your GitHub account
Log in to GitHub in a second tab. This ensures that your password and username do not require additional security verification. When logged in to GitHub, return to Marker.io and try connecting your GitHub account.
Reset your password on GitHub
Try setting a new password in your GitHub account and see if that helps to resolve the issue.
Still not working?
Please start a chat conversation with us in the lower right corner of your screen.
How to enable GitHub Organization Projects (beta)
Make sure you have access to GitHub Projects
Check your permissions on your Org Projects
You need to have Read and Write access to org
Organisation access also need to be enabled.
See 3 green ticks on the image below for example:
How to give Read and Write access?
Resync your GitHub account from within your Marker.io Shared account settings:
Settings > Workspace > Shared accounts
You should now be able to load your Organization projects and add Marker.io issues to these projects using the Project field.
I can't access all of my GitHub Organizations.
If you have more than one GitHub organization, ensure that Marker.io has been granted access to them, navigate to:
Click on Marker.io and Grant access to any organization you wish Marker.io to access.
I can't disconnect my GitHub account from Marker.io.
Disconnect GitHub inside Marker.io
Go to workspace settings -> Personal -> Accounts and Disconnect your GitHub account.
Revoke Marker.io access inside Github
Log into your GitHub account and go to your applications settings and revoke the Marker.io app here https://github.com/settings/applications
You should now be able to connect to a new GitHub account.
Invite your team to collaborate on a dedicated GitHub project today with Marker.io, where anyone can report bugs and feedback in seconds. We have many advanced features for you to explore. See Marker.io Academy, which we continuously update with our latest features.