# Quickstart

### Get Started with BetterBugs.io

Hey there! We're excited to see you. 

If you're annoyed with the traditional bug-reporting and debugging process while ensuring your software quality, BetterBugs.io is for you.

### Quick Installation

<a href="https://chrome.google.com/webstore/detail/betterbugs-a-fresh-approa/mdljmlgokccncglfobogbfjgcijldnaj" class="button primary">Add to Chrome</a>

1. Integrate the **BetterBugs.io FREE extension** using the button above and pin it to your browser toolbar for quick access.
2. Click the extension icon on your browser. It takes you to the [login screen of BetterBugs](https://app.betterbugs.io/login).&#x20;
3. Sign up with your email address and hit "**Continue**". Confirm your account with the OTP received in your email. Alternatively, you can sign up with your **Google** or **GitHub** account.&#x20;

Okay, you're all set to create your first bug report.

### How to Create a Bug Report using BetterBugs.io \[Step-by-Step]

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBzBhuIUDDav7ztnadaoO%2Fuploads%2FMzo5LRaUizWglQK2oSIx%2F01-Getting-Started-with-Your-First-Bug-Report-using-BetterBugs.mp4?alt=media&token=dd2b79d7-65e0-4b9c-a3a9-a733b529f1d1>" %}
How to Create a Bug Report using BetterBugs.io | Video Demo
{% endembed %}

{% stepper %}
{% step %}

#### Capture the Issue

Use the extension to capture the bug using the screenshot or screen recording option. For instance, click "[**Capture Screenshot**](https://docs.betterbugs.io/product-features/screen-capturing/cropped-screenshot)" in the "**Crop**" mode. Drag and select the screen area you want to capture. This instantly captures a snipped screenshot.&#x20;

The [technical details](https://docs.betterbugs.io/product-features/developer-tools) \[*system info, console logs, network requests, page navigation steps, and other devtools info*] are automatically attached to the report. You can also add custom metadata for the report, if required.

{% hint style="success" %}
Alright! You just captured your first bug. That's how easy it is.
{% endhint %}
{% endstep %}

{% step %}

#### Annotate the Screenshot

Use the markup toolbar at the left to highlight the issue.&#x20;
{% endstep %}

{% step %}

#### Enter Issue Details

You can add the details (**Title + Quick Summary + Steps to Reproduce**) manually in the description area manually or automatically with the "**AI**" toggle.

Use the "**Details**" and "**Tags**" section below the description area to assign:

* Status
* Priority
* Assignee
* Custom Tags
  {% endstep %}

{% step %}

#### Select BetterBugs Workspace and Project

From the two dropdowns above the description area, select:

* **Workspace** (Default: My Workspace)
* **Project** (Default: My Project)

This is where your report saves once you create a session.
{% endstep %}

{% step %}

#### Create Session

Finally, hit "**Create Session**" button on the top right.
{% endstep %}
{% endstepper %}

This creates a report session and opens the report in a new tab. The report link gets auto-copied to the clipboard, so you can share it with others to access the complete report.&#x20;

You can also add the following to your bug report:

* **Annotations and Markups:** Add markups to highlight the issue.
* **Add tags**: Up to 10 tags.
* **Upload files**: Supported file types -> Doc, Excel, PDF, Txt, Image, and Video: Max of 5 files/report.
* **Metadata**: Add custom `key : value` as **Title** and **Value** pairs in the devtools "**Metadata**" tab.
* **Status**: Open, In Progress, Closed.
* **Priority**: Urgent, High, Medium, Low (By default, all reports are marked with Medium priority level).
* **Assignee**

You can also integrate BetterBugs with your preferred project management tools and issue trackers, such as Jira, GitHub, Asana, Linear, and many others. [Check out the steps for it](https://docs.betterbugs.io/product-features/integrations).