Collect website feedback as new issues directly in your GitLab projects. With our 2-way synchronization, your issue status, fields, and comments are always in sync.
Set up a GitLab 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 project 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 GitLab account.
Configure forms
We fetch your native GitLab fields into your widget form. You can show/hide any fields and preset fields. For example, set the default Due Date and allow your reporters to change that where needed.
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 GitLab 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 GitLab 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 GitLab.
Synchronize Status
Once you update an issue status to “done” within GitLab, 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 GitLab?
Admin permissions are required on the GitLab project you wish to connect with.
I can't connect my GitLab account to Marker.io
Any issues setting this up? Try the following:
Log in to your GitLab account
Log in to GitLab in a second tab. This ensures that your password and username do not require additional security verification. When logged in to GitLab, return to Marker.io and try connecting your Gitlab account.
Reset your password in GitLab.
Try setting a new password in your GitLab 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 do I add custom fields in Marker.io via the GitLab Integration?
Custom fields are currently unavailable on GitLab. Considering upvoting the feature request on their website.
How can I set a default time estimate for Gitlab tickets?
To set a default time estimate for your Gitlab tickets, you can use the Time estimate field we sync from GitLab.
You can add any value to the preset field and keep that field hidden if you don't want your reporters to change it.
Here are some sample values you can use:
15 m | 15 minutes |
1 h | 1 hour |
1 d | 1 day |
Below is a copy of what is currently available from Gitlab. Keep an eye on GitLab docs to stay up to date on these values.
When should I use a Personal Access Token instead of standard authentication?
If you are using the self-managed version of GitLab, you will need to provide a Personal Access Token to integrate Marker.io with your GitLab account.
Open your GitLab account and navigate to the Personal Access Token tab.
Create an access token by following those steps:
Type a name for your token.
Leave the expiratory date empty.
Under Scopes, select API.
Click the button to create your token.
Copy your new Personal Access Token.
Go back to your Marker.io account and connect your GitLab account using your Personal Access Token
To learn more about Personal Access Token, you can read the relevant documentation at GitLab.
How do I find my self-hosted GitLab URL
Open GitLab in your web browser
Copy the address from your browser's address bar.
You may need to tap or click the address bar in some browsers to see the full URL.
If you're viewing the dashboard, the GitLab URL is everything that comes before /dashboard.
My self-managed GitLab is behind a firewall
If your GitLab instance is publicly accessible and behind a corporate firewall, you will need to allow our servers using the IP: 52.17.43.230
I can't connect my self-hosted GitLab account.
Make sure you are using the self-managed version of GitLab.
If your GitLab account is a cloud-based GitLab account (hosted on gitlab.com), it should work out of the box using a standard authentication process. You need to select GitLab.com when adding an account.
If your GitLab host looks like this: gitlab.mycompany.com. Then you are using the self-managed version.
Make sure you are using a valid host.
Enter your host following this format: https:// gitlab . my company . com
If you need help finding your GitLab host, see above.
Make sure you generated a valid Personal Access Token
To integrate Marker.io with a self-managed instance of GitLab, you need to authenticate using a Personal Access Token. See above.
How do I use Marker.io with more than one GitLab Account?
If you'd like to connect a second GitLab account to your Marker.io account, you'll need to
Disconnect the first GitLab account.
Ensure you use a unique email address for each Jira account you wish to add.
Disconnect the first GitLab account:
Note: Any project you have already connected with this account will continue to work.
Navigate to https://app.marker.io/settings/me/accounts
Disconnect the first GitLab account
Add a new project using your second GitLab account
Ensure that you use a unique email address for your second GitLab account
Navigate to: https://app.marker.io/projects -> Create Project
Give your project a name, choose the website that you will collect feedback from, and choose GitLab as the integration.
Now walk through the standard GitLab installation. Ensure that you are logged in to Gitlab on another browser tab using the second GitLab account credentials.
Invite your team to collaborate on a dedicated GitLab 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.