# 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**](/product-features/screen-capturing/cropped-screenshot.md)" in the "**Crop**" mode. Drag and select the screen area you want to capture. This instantly captures a snipped screenshot.&#x20;

The [technical details](/product-features/developer-tools.md) \[*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](/product-features/integrations.md).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.betterbugs.io/getting-started/quickstart.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.