Ybug

Overview

Ybug is a visual feedback and bug reporting widget that lets teams and website visitors report issues without leaving the page. The Shortcut integration turns every report into a Story automatically, with the context developers need to reproduce and fix the issue.

Key Features

  • Annotated Screenshots: Reports include marked-up screenshots of the issue
  • Screen Recordings: Capture what led up to the report
  • Technical Context: Console logs, browser, OS, and page URL are attached automatically
  • Automatic Stories: Every report becomes a Shortcut Story with the Bug story type
  • Linked Back: Each Story links back to the original Ybug report

Setting Up the Integration

  1. In Shortcut, go to Settings > API Tokens and generate a new token
  2. In Ybug, open your project’s Integrations settings and enable Shortcut
  3. Paste in the token and click Authenticate with Shortcut
  4. Select the Shortcut Workflow to use for new Stories, and optionally a team, epic, owner, and labels
  5. Save your settings

Once connected, Ybug creates a Story for every new report using the selected Workflow’s default state. If you need to change the Workflow, team, epic, owner, or label mapping later, update it from the Integrations settings in Ybug.

This integration is maintained by Ybug. See the official Ybug documentation for more details.