Guides for setting up BugSense, reading results, and connecting alerts.
Create your account
Sign up at bugsense.app without a credit card. You start with a 7-day free trial on any paid plan.
Add your first website
Go to the Websites page, click "Add Website", and enter a URL (e.g. mysite.com). If you run a Shopify store, install BugSense from apps.shopify.com/bugsense and your store shows up in BugSense on its own.
Shopify merchants: install from the App Store
Open apps.shopify.com/bugsense and click Install. Shopify walks you through the OAuth approval, then BugSense opens inside your Shopify Admin under Apps with your store linked. The Shopify setup guide covers each step.
Run your first scan
Click "Scan now" on a website card. BugSense opens a headless browser, takes screenshots on Mobile, Tablet, and Desktop, then runs the AI analysis. Most scans finish in 60–90 seconds.
Review the report
Each issue shows the affected viewport, a screenshot, a plain-English description, and an AI fix (a CSS or copy change). BugSense ranks issues High, Medium, or Low by conversion impact.
What gets checked
BugSense checks layout, broken images, overlapping elements, cut-off text, mis-sized tap targets, CLS (layout shift), slow load times, and form usability at all three viewport widths.
AI analysis
A vision AI model reads each screenshot the way a visitor would. It flags the issues a human QA tester would catch, on top of automated rule failures.
Scanning pages behind login
Add your login URL, email, and password in the website's Settings panel. BugSense signs in before it scans protected pages like checkout, account, or dashboard.
Scan limits
Your plan sets the limit (Starter: 60/month, Pro: 300/month, Agency: 1,000/month). Manual scans and auto-tests both count toward it.
Enable auto-testing
Open a website's settings and turn on "Auto-test enabled". BugSense scans the site daily on Starter, every 6 hours on Pro, and hourly on Agency.
New-issue alerts
When an auto-test finds a new high-severity issue, BugSense alerts you through the integrations you set up (Slack, Teams, email, webhook).
Theme Change Shield
On Pro and Agency plans, BugSense watches for Shopify theme edits and starts a scan within minutes of a publish, so you see new high-severity issues before customers do.
Dashboard overview
The dashboard shows your Website Health Score (0–100), open issues by severity, and a chart of issues over time. Above 80 is healthy. Below 60 means visitors can probably see problems that cost you conversions.
Shareable reports
Click "Share report" on a scan result to create a public link. A developer or client can open it without logging in. You can turn links off from the Websites page.
Closing issues
After you fix an issue, mark it resolved and BugSense keeps it in history. If a later scan finds the same problem, BugSense reopens it.
Slack & Microsoft Teams
Go to Settings → Integrations and paste your Slack Incoming Webhook URL or Teams webhook URL. BugSense posts a message when it finds a new high-severity issue.
Custom webhook
Set a webhook URL for each website in its Settings panel. BugSense sends a POST request with the scan results as JSON when a scan finishes.
GitHub
Add your repo URL in website Settings. When BugSense finds a high-severity issue, it can open a GitHub Issue with the description and suggested fix.
Uptime monitoring
Turn on "Uptime monitoring" for a website. BugSense pings it every few minutes and alerts you if it goes down.
Email us at [email protected]. We reply within 24 hours.