User Acceptance Testing (UAT) helps ensure that your product works as expected for your users. With Marker.io, reporting and managing issues during UAT becomes much easier. This guide will walk you through how to use Marker.io effectively for your UAT process.
1. What Is Marker.io?
Marker.io is a tool that lets testers and users report issues directly from your website or application. It captures detailed information like screenshots, browser details, and console logs to help your team fix bugs faster.
2. Set Up Marker.io for UAT
Follow these steps to get started with Marker.io:
Step 1: Sign Up and Create an Account
Go to app.marker.io and sign up for a trial account.
Once signed in, create a new marker project for your UAT project.
Step 2: Connect Your Issue Tracker
Marker.io integrates with tools like Jira, Trello, ClickUp, and more. Connect your workspace to your preferred issue tracker:
Click Integrations in the workspace settings.
Choose your issue tracker and follow the on-screen instructions to connect it.
Step 3: Install the Marker.io Widget
Copy the installation code snippet from your workspace.
Add the snippet to your website or application where you want users to report issues.
Customize the widget appearance to match your brand (optional).
3. How to Report Issues During UAT
Once Marker.io is set up, here’s how testers can report issues:
Using the Marker.io Widget
Click the Marker.io widget on your website.
Take or annotate a screenshot to show the issue.
Fill in the issue details:
Title: A brief description of the issue.
Description: Additional details about the problem.
Priority: (Optional) Select the priority level (low, medium, high).
Submit the issue. It will automatically appear in your connected issue tracker with all the details.
Information Automatically Collected
Marker.io helps your team by including:
A screenshot or video of the issue.
The tester’s browser, device, and operating system details.
Console logs and network activity for troubleshooting.
4. Managing Reported Issues
After testers submit issues, your team can manage them in your issue tracker:
Open your issue tracker (e.g., Jira, Trello, or Asana).
Review the submitted issues. Each report includes:
The screenshot or video.
Automatically captured technical details.
Notes added by the tester.
Assign and Fix Issues
Assign issues to the appropriate team member.
Track progress directly in your issue tracker.
5. Tips for Better UAT Reporting
Be Specific: Ask testers to give detailed titles and descriptions for each issue.
Encourage Annotations: Use the annotation tools in Marker.io to highlight problem areas in screenshots.
Review Regularly: Check for new issues in your issue tracker daily.
6. Frequently Asked Questions
Do testers need a Marker.io account?
No, testers can submit issues using the widget without signing up.
Can I customize the widget?
Yes, you can change the widget’s color, position, and instructions in your workspace settings.
Does Marker.io work on staging environments?
Yes, you can install Marker.io on any website, including staging environments.
7. Other Ways to Use Marker.io for UAT
Beta Testing: Use Marker.io to collect issue reports from beta testers.
Internal QA: Enable your QA team to document bugs quickly and accurately.