Use Case

Visual Bug Tracking & Issue Reporting

Capture visual bugs with context-rich screenshots for developers. Attach screenshots to bug reports automatically.

Overview

"It doesn't look right" is the most common bug report. Without a screenshot, developers waste time reproducing issues. Automated visual bug tracking captures the exact state of the page with full context—viewport size, browser, URL, and visual state.

Screenshotly integrates with bug tracking tools like Jira, Linear, and GitHub Issues to attach screenshots automatically. When users report issues, capture the page state and attach it to the ticket. Developers see exactly what the user saw.

For QA teams, scheduled captures across browsers and devices catch visual regressions before users report them. Compare current screenshots against baselines and auto-create tickets when differences exceed thresholds.

Key Benefits

Screenshot context with every bug report

Automated visual regression detection

Integration with Jira, Linear, GitHub

Cross-browser issue documentation

Results You Can Expect

Contextual

bug screenshots

Automated

regression detection

Integrated

with issue trackers

How It Works

Integrate screenshot capture into error handling

Attach screenshots to bug tracking tickets

Set up visual regression monitoring

Compare across browsers and devices

Auto-create tickets for visual changes

Code Example

// Capture bug context screenshot
const captureBugReport = async (pageUrl, errorDetails) => {
  const screenshot = await fetch('https://api.screenshotly.app/screenshot', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      url: pageUrl,
      device: 'desktop',
      format: 'png',
      fullPage: true,
    }),
  });

  // Create Jira ticket with screenshot
  await createJiraTicket({
    summary: 'Visual bug: ' + errorDetails.title,
    description: errorDetails.description,
    attachment: screenshot,
  });

  return screenshot;
};

Frequently Asked Questions

Can I capture screenshots on user-triggered error reports?

Yes! Add a 'Report Bug' button that captures the current page state via API and creates a ticket with the screenshot attached.

How do I integrate with Jira or Linear?

Use their REST APIs to create tickets with screenshot attachments. Capture the screenshot, upload it, and reference it in the ticket creation payload.

How do I attach screenshots to Jira tickets automatically?

After capturing the screenshot via the Screenshotly API, upload it as an attachment using Jira's REST API (/rest/api/3/issue/{key}/attachments) with the screenshot binary. You can wire this into your error handler so every unhandled exception automatically creates a Jira ticket with a full-page screenshot attached.

Can I annotate screenshots before filing a bug?

Screenshotly provides clean capture; for annotations, pipe the returned image through a lightweight canvas library (like Sharp or Jimp in Node.js) to add arrows, highlights, or bounding boxes before attaching to the ticket. This keeps bug reports clear without requiring a separate annotation tool.

Want a step-by-step walkthrough?

Read: Visual Regression Testing Guide →

Ready to automate bug tracking?

Get started with 100 free screenshots. No credit card required.

Start Free Trial Try Playground