Notion

Create and send bug reports instantly to your Notion project as tasks.

BetterBugs integration with Notion

With BetterBugs and Notion integration, you can seamlessly share detailed bug reports as tasks in your Notion project workspace, 10X faster. BetterBugs enables you to create and share comprehensive, context-rich, and technically sound bug reports bundled with visual proofs and devtools details, such as reporter information, issue link, logs & diagnostics, environment information, and more in a few clicks, right from the browser.

Get everything you need as a developer from your Quality Assurance (QA) teams, co-developers, stakeholders, or support teams right to your Notion project for faster debugging sessions and better bug management processes.

How to Integrate BetterBugs Project with Notion: Step-by-Step

How to Integrate BetterBugs Project with Notion: Video Demo

Here, we've covered the steps to integrate a single BetterBugs project (within your BetterBugs Workspace) with Notion. You can also integrate the complete BetterBugs Workspace in one go (that includes all the projects within your Workspace) to Notion or any other project tool. Check out the steps for Workspace Integration.

1

Open Workspace Settings > Integrations

Click on BetterBugs Workspace name at the top left side of app screen. Now, click the gear icon to open Workspace Settings > Integrations.

2

Search Notion

In the Integrations tab, search for Notion and click to open the Notion card.

3

Turn off workspace-wide integration

Toggle off the "All Projects" option and hit "Continue". You should see the "Manage per project" option now.

By default, its turned on for workspace level integration. For project-wise integration, you need to disable "All Projects".

4

Select a BetterBugs project to integrate and hit "Connect"

Select a project from the projects name list (that's within your Workspace). From the "Actions" column, hit "Connect" for that project.

5

Authorize BetterBugs.io for Notion

Hit “Allow access” to authorize BetterBugs.io for your Notion page.

IMPORTANT NOTE

If you're on a free plan, Steps 6 and 7 are NOT REQUIRED. You can just SKIP to "How to Create Bug Report on Notion using BetterBugs" section on this page.

FOR PAID PLANS (Teams and Enterprise)

Steps 6 and 7 enables you to explicitly choose between:

• Manual Ticket Creation (Default): This means for sharing a bug report to Notion, you'd need to manually populate fields for Notion (Database, Environment, and others). Its a FREE FEATURE.

• Automatic Ticket Creation: This means for sharing a bug report to Notion, you can configure BetterBugs to auto-populate fields for your Notion page (Database, Environment, and others). Its a PAID FEATURE.

6

Optional: Choose your preferred method for creating tickets: Manually or Automatically

From the "Forward Bug Reports" dropdown, select your preferred method for creating tickets in your project tool:

• Manually: Enables you to create tickets manually. Here, we've selected the manual method to showcase project integration steps.

• Automatically: Enables you to create tickets with automation.

7

Optional: Select "Manually" and Connect

Finally, select "Manually" from the "Forward Bug Reports" dropdown and hit "Connect".

Okay! You're good to go with the Project level integration for Notion. Now, you can create detailed reports and share them as Notion tasks directly from your browser with a few clicks.

How to Create Bug Report on Notion using BetterBugs

How to Create Bug Report on Notion Page using BetterBugs: Video Demo

1

Capture the Bug and Add Bug Details

Use the BetterBugs extension to capture the bug and add details for it. You can add the details (Title + Quick Summary + Steps to Reproduce) manually in the description area manually or automatically with the "AI" toggle.

2

Select BetterBugs Workspace and Project Integrated with Notion

From the two dropdowns above the description area, select:

• BetterBugs Workspace

• BetterBugs Project (that you integrated with Notion)

3

Click "+ Send to your PM Tool" Dropdown and Select Notion Page

Open "+ Send to your PM Tool" dropdown and select "Notion Page".

4

Populate Task Details for Notion and Hit "Next"

Populate Notion Fields for the report: Database, Environment, and others and click "Next".

5

Create Session

From the top right, click "Create Session".

There you go!

A new tab with the Notion task opens up posting the task to the Notion page packed with all the bug details and a link to the complete bug report with developer tools info.

• Use the report link in your Notion task to access the complete report on BetterBugs.

• You can also access the Notion task from the BetterBugs report from the "Comments & Activities" tab located below the bug description area.

How to Send Existing BetterBugs Report to Notion Page

How to Send Existing BetterBugs Report to Notion Page: Video Demo

1

Open a Bug Report

Login to BetterBugs and open a project report to share on Notion.

2

Click "+ Send to your PM Tool" Dropdown and Select Notion Page

From the top-right of the report screen, open "+ Send to your PM Tool" dropdown and select "Notion Page".

3

Populate Task Details for Notion and Click "Create Task"

Populate Notion Fields for the report: Database, Environment, and others and click "Create Task".

Okay! You're all set. This instantly should create Notion task with the BetterBugs bug report.

How to Disconnect BetterBugs Project from Notion

How to Disconnect BetterBugs Project from Notion: Video Demo

1

Open Project Settings

Use the Gear Icon beside the BetterBugs Project Name to open Project Settings.

2

Go to Workspace Settings > Integrations

Navigate to Workspace Settings > Integrations

3

Search Jira

In the Integrations tab, search for Notion and click to open the Notion card.

4

Select BetterBugs project to disconnect and click (⋮) under "Actions"

In the Notion card, select the BetterBugs project (from the Project list) to disconnect. For the project, click vertical dots (⋮) under the Actions column.

5

Disconnect and Confirm Action

To confirm action, click "Disconnect" and "Continue".

This instantly disconnects Notion from the selected BetterBugs project.