# Session filters

Once you log into your BetterBugs.io account and open a project, you get the "**Search Session**" box to search through the logged bug reports or sessions.

### Where is the Filters Option in BetterBugs.io?

For filtering out reports, you’ll find a “**Filters**” button at the right side of project sessions screen. Click it for various filter value options.&#x20;

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBzBhuIUDDav7ztnadaoO%2Fuploads%2FvAz5GrbjbkZudCiDiPGn%2F01-Report-Sessions-Filter-Options-for-BetterBugs.io.mp4?alt=media&token=e7106f37-21e8-497b-b13f-07a696496eaa>" %}
BetterBugs.io Project Reports/Sessions Filter Options | Video Demo
{% endembed %}

### What are the Filters Available in BetterBugs.io for Searching Report Sessions?

Here’s a table summarizing the available filters in BetterBugs.io for report sessions:

<table><thead><tr><th width="151.4444580078125">Filter Name</th><th width="374.5555419921875">Description</th><th>Available Values</th></tr></thead><tbody><tr><td><strong>Priority</strong></td><td><p>Filter reports based on assigned priority levels. </p><p></p><p>By default, every report you create gets marked with a “<strong>Medium</strong>” priority level which you can change while adding details to it.</p></td><td>Urgent, High, Medium, Low</td></tr><tr><td><strong>Status</strong></td><td><p>Filter sessions for the reports based on status. </p><p></p><p>The session gets auto-marked as "<strong>Open</strong>" when you capture a screenshot/video. This can be later updated to <strong>In Progress</strong> or <strong>Closed</strong> after the session is uploaded to your BetterBugs.io account. Then, you can filter the results based on status.</p></td><td>Open, In Progress, Closed</td></tr><tr><td><strong>Creator</strong></td><td>Filter sessions for the reports based on the person who created them.</td><td>List of all issue creators for the project reports</td></tr><tr><td><strong>Assignees</strong></td><td>Filter sessions based on the assignees for the reports</td><td>List of all assignees for the project reports</td></tr><tr><td><strong>Tags</strong></td><td>Filter sessions for the project based on the tags attached to it.</td><td>List of custom tags added for the project</td></tr><tr><td><strong>Integrations</strong></td><td>Filter sessions based on the project management tools, issue trackers, or communication tools they’ve been shared with.</td><td>Asana, Azure Boards, ClickUp, GitHub, Jira, Linear, Microsoft Teams, Slack, Trello, and others.</td></tr><tr><td><strong>Creation Source</strong></td><td>Enables you to search report sessions based on report creation method/tool used within BetterBugs.io</td><td><ul><li><a href="../getting-started/quickstart">Chrome Extension</a></li><li>Mobile SDK</li><li><a href="../developer-guide/betterbugs-web-sdk">Web SDK</a></li><li><a href="../product-features/recording-links">Recording Link</a></li></ul></td></tr><tr><td><strong>Date Range</strong></td><td>Filter sessions for the desired date range.</td><td>Start date - End date</td></tr><tr><td><strong>Deleted  sessions</strong></td><td>Filter sessions that're deleted for the project.</td><td>Deleted sessions only</td></tr></tbody></table>

### How to Use Session Filters in BetterBugs.io?

Here's how to use the session filters in your BetterBugs.io project:

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBzBhuIUDDav7ztnadaoO%2Fuploads%2F80BdtGq2Kmd4xR9MNXOV%2F02-Howw%20to%20Use%20Session%20Filters%20in%20BetterBugs-io.mp4?alt=media&token=b9dfbe75-412e-426a-9d3d-4f138285842b>" %}
How to Use Session Filters in BetterBugs.io | Video Demo
{% endembed %}

{% stepper %}
{% step %}

#### Open BetterBugs.io Project

Open a project from your BetterBugs.io workspace.
{% endstep %}

{% step %}

#### Click the "Filters" button

Click “**Filters**” located at the right of the the “**Search Session**” box.
{% endstep %}

{% step %}

#### Select Session filter(s) and Apply

Select your filter(s) and add the desired values for each. For instance, let's set the:

* “**Priority**” to “**Urgent**” and click "**Apply Filter**".
* “**Status**” to “**Open**” and click "**Apply Filter**".
  {% endstep %}
  {% endstepper %}

This gives you all the reports that match these two selections together. Your filters be visible beside the “**Filters**” button with the desired selection.&#x20;

For the given example, you’ll see the “**Priority Is Urgent**” and “**Status Is Open**” getting displayed.

### How to Toggle Filter Logic (Is/Is Not) in BetterBugs.io for Report Sessions?

You can also toggle the “**Is**” to “**Is Not**” to tweak the logical combination for filtering the reports. To toggle it, just press the “**Is**” (*and vice versa*) text sitting between the filter name and value.&#x20;

Check out the video demo below.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBzBhuIUDDav7ztnadaoO%2Fuploads%2FXTk5Tmx5tfwZJfpjgq4a%2F03-Logic-Change-for-Filterering-Sessions.mp4?alt=media&token=1bed2e4c-ceb4-41ae-9f4c-38b8e8fbbc7a>" %}
How to Toggle Filter Logic in BetterBugs.io | Video Demo
{% endembed %}

### How to Remove All Filters for Report Sessions in BetterBugs.io?

To remove all filters for sessions, you have the “**Clear**” option on the right-hand side.

<div data-with-frame="true"><figure><img src="https://3235868439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBzBhuIUDDav7ztnadaoO%2Fuploads%2FeYdVHjDqNAJnygfG3hjB%2F03-Clear-All-Filters.png?alt=media&#x26;token=09ccecb2-191f-45f1-94eb-7ec0dae26f78" alt=""><figcaption><p>Clear All Filters for BetterBugs.io Report Sessions</p></figcaption></figure></div>

### How to Add Multiple Values for a Specific Filter in BetterBugs.io?

You can also add one or more values for a specific filter, allowing you to tweak your filters required. For instance, you can select one or more “**Priority**” (or any other filter) levels for your reports. &#x20;

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBzBhuIUDDav7ztnadaoO%2Fuploads%2FVqtAaSYnW95sLJY6mFQv%2F05-Select-Multiple-Values-for-a-Specific-Filter.mp4?alt=media&token=7d5b38b4-a23d-4f8e-96b1-8107c451fcab>" %}
Add Multiple Values for a Specific Filter in BetterBugs.io | Video Demo
{% endembed %}

{% stepper %}
{% step %}

#### Click "Filters"

In your BetterBugs.io project, click "**Filters**"
{% endstep %}

{% step %}

#### Add Multiple Values for a Specific Filter

Select multiple values for a specific filter.&#x20;

For instance, for "**Priority**", set the filter values to:

* **Urgent**
* **High**
  {% endstep %}

{% step %}

#### Confirm&#x20;

Click "**Apply Filter**" to save.
{% endstep %}
{% endstepper %}

Okay! You're good to go with your filter.

Here’s how it looks: **Priority Is Urgent, High**

### How to Add and Save Custom Filters for Report Sessions in BetterBugs.io Project?

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBzBhuIUDDav7ztnadaoO%2Fuploads%2F8lplTo59RaSi2GtTAY0r%2F06-Add-Custom-Filters-for-Report-Sessions.mp4?alt=media&token=64e8b839-3a42-4c82-9ecd-4a620876d338>" %}
Steps to Add and Save Custom Filters for Report Sessions in BetterBugs.io | Video Demo
{% endembed %}

{% stepper %}
{% step %}

#### Add Filters

Add the desired filters for your sessions using the "**Filters**" button and apply changes.
{% endstep %}

{% step %}

#### Save View

Now, click the “**Save View**” button available on the right.
{% endstep %}

{% step %}

#### Enter Custom Filter Name

Enter your custom filter name.
{% endstep %}

{% step %}

#### Select Filter Visibility

Select between:

* **Private** — Only you can view and use that filter.
* **Everyone in this project** — Everyone added to that project can see and use that filter.
  {% endstep %}

{% step %}

#### Save your filter

Finally, hit “**Save**”.  You're good to go.
{% endstep %}
{% endstepper %}

### How to Edit or Delete Custom Filters for Report Sessions in BetterBugs.io Project?

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBzBhuIUDDav7ztnadaoO%2Fuploads%2F3v8ndvEewIefrsJHxs9y%2F07-Edit-or-Delete-Filters-for-Custom-Filters.mp4?alt=media&token=4bf9380d-dabd-4961-9ada-fb20c5ffa9fa>" %}
How to Edit Custom Filters for Report Sessions in BetterBugs.io | Video Demo
{% endembed %}

{% stepper %}
{% step %}

#### Open Filters Dropdown using the Three Vertical Dots (⋮) Icon

Click the three vertical dots (⋮) icon of the Customer Filter to open dropdown.
{% endstep %}

{% step %}

#### Choose Between Edit view OR Delete view

Select:

* **Edit View** - Check following steps for it.
* **Delete view** - If you wand to delete the filter, click on this option and confirm deletion.&#x20;
  {% endstep %}

{% step %}

#### Make the Required Changes for Filter Name and Filter Visibility

Make edits to the:

* **Filter Name**
* **Filter Visibility**
  * Private&#x20;
  * Everyone in this project
    {% endstep %}

{% step %}

#### Edit Filter(s)

Click the existing filter(s) to edit or add the new ones using the "**Add Filter**" button.
{% endstep %}

{% step %}

#### Save

Finally, hit “**Edit**” to save the changes.
{% endstep %}
{% endstepper %}

Here you go! You should be good to go with your new filter.


---

# 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/sessions/session-filters.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.
