StorePulse User Guide

Everything you need to know about installing, configuring, and getting value from StorePulse.

1. Install & setup

Open the StorePulse listing on the Shopify App Store and click Install. Approve the requested permissions on Shopify's consent screen — read products, themes, orders, and inventory; write a script tag and a metafield used by the Theme App Embed.

After install, StorePulse opens to the dashboard. Two things happen automatically:

1. A snippet token is generated and stored as a Shopify metafield. The Theme App Embed uses this to authenticate event ingestion.
2. The StorePulse Web Pixel is registered for checkout-funnel tracking.

Open Online Store → Themes → Customize on your published theme. In the App embeds section, enable StorePulse Tracking and click Save. That's the only manual step.

Visit your storefront once. Within 30 seconds, the Settings page should show Storefront tracking delivered: active on storefront.

2. Dashboard tour

The dashboard at /app shows a "today snapshot" — open errors, open alerts, push-recovery ROI, plus a "customer revenue at risk" headline. Each card links to its detail page. Use this as a daily check-in; jump to a feature page for deeper analysis.

3. Errors monitoring

The Errors page lists JavaScript errors and unhandled rejections grouped by stack signature. Click an issue to see:

• First seen / last seen timestamps and total occurrences.
• The full stack trace from the most recent occurrence.
• Per-page distribution — which URLs trigger this error.
• Status (open / resolved / ignored). Mark resolved when you've shipped a fix; the issue auto-reopens if it occurs again.

Use the filter chips at the top to narrow by type (JS error, unhandled rejection, network error, cart error, checkout error) or status. Search by message or stack text.

4. AI fixes

From any error detail page, click Get AI fix (2 credits). StorePulse sends the error message, stack trace, and recent samples to Claude (Anthropic) and returns a structured fix proposal:

• Why it broke — root cause analysis.
• File path — the theme file to open in Code Editor.
• Before code — the exact snippet to find.
• After code — the safe replacement.
• How to verify — what to test in the browser console or storefront.

The fix is a recommendation, not an automatic patch. Review it, paste into your theme via Shopify's Code Editor, save, and visit the affected page to confirm the error is gone. Mark the issue resolved.

AI fixes are pay-as-you-go: $0.05 per credit, 2 credits per fix ($0.10). Buy credit packs ($5 to $100) whenever you need them — credits never expire. If the fix is wrong (rare), email support@deepseatools.in with the issue ID — we credit the cost back and improve the prompt.

5. URGENT cart-failure alerts

Available on every plan. The storefront snippet wraps window.fetch and XMLHttpRequest and watches every cart-mutation request — /cart/add, /cart/change, /cart/update, /cart.js, /checkouts/. The first time any real visitor's browser hits a 4xx, 5xx, or network failure on one of those endpoints, an URGENT alert fires within five minutes.

No spike threshold, no two-failure observation window — one broken customer is already revenue lost. The alert message names the failing endpoint, the phase bucket (server error / client error / request failed), and the page the customer was on, so you can reproduce the breakage immediately.

Auto-resolve: when a real customer successfully adds to cart (or reaches checkout, for checkout failures) within the next 30 minutes, the open alert is flipped to resolved automatically. No "recovered" email — your team isn't paged twice for the same incident.

Quota-free: cart_action_failed events never count against your monthly error budget, so a broken theme can't burn through your plan during the outage.

6. Push Recovery

Available on Starter+. The storefront snippet asks for browser push permission at strategic moments (right after add-to-cart). When a shopper abandons their cart past the configured threshold (default ~5 minutes, configurable per plan), StorePulse delivers a push that links straight back to /cart with a merchant-customized title, body, and product image.

Two privacy / deliverability features are built in:

• Only-on-issue mode — push delivery is gated on a correlated technical issue in the shopper's session (JS error, network failure on /cart or /checkout, rage click). Stops "we just want your money" sends when nothing was actually broken.
• Wave delays — staggered delivery across configurable wave buckets so all pushes don't fire in the same minute and hammer your storefront.

The Push recovery dashboard card shows pushes sent → carts recovered → revenue back over the last 7 days, so the feature's ROI is visible at a glance.

7. Live visitor intelligence

The Live tab streams every active visitor session on your storefront as it happens. Six sub-tabs let you slice by what you care about:

• Orders — successful purchases as they're placed, with cart contents, total, and UTM attribution.
• Carts — in-progress carts with line-item detail and time-on-page.
• Abandoned — carts that went idle past the push-recovery threshold.
• Products — what's getting viewed right now, ranked by velocity.
• UTM — which campaigns are driving the active visitors.
• Referrals — incoming traffic by referrer host.

Pro+ unlocks the IP intelligence drawer — click any visitor row to see ASN, network classification, bot score (from Cloudflare's botManagement), and the full page-by-page journey. Scraper and skim attempts stand out immediately.

8. Alerts

StorePulse fires email alerts when something matters. The Alerts page shows recent alerts with filters for severity, type, status, and time range. Each alert can be marked resolved or reopened. New-issue alerts dedupe per fingerprint — one email per unique error, not per occurrence.

Configure alerts under Settings → Alert notification emails. Add up to 3 recipient emails. Per-rule toggles let you enable/disable each alert type and set thresholds for spike-based rules.

9. Settings

The Settings page consolidates all configuration:

• Storefront tracking — installation status, snippet token, observed URL count.
• Activation checklist — confirms install / delivery / events.
• Tracking controls — reconnect or remove tracking.
• Alert notification emails — up to 3 recipients.
• Alert rules — per-rule toggles and thresholds.

10. Billing

The Billing page shows your current plan, error quota usage for the month, and active subscription details. Click any plan card to upgrade or downgrade — Shopify handles approval and pro-ration automatically. Every paid plan comes with a 7-day free trial; one trial per shop, lifetime.

AI credits are pay-as-you-go via one-time credit packs ($5 / $10 / $25 / $50 / $100). Credits never expire. Usage-warning banners appear at 80% and 100% of your monthly error quota.

11. Uninstalling

Before uninstalling, click Remove StorePulse tracking in Settings. This deletes our app embed token so your storefront stops loading our snippet immediately.

Then uninstall from Shopify Admin → Settings → Apps. We soft-purge sensitive data (access tokens, integration secrets, alert emails) the moment Shopify fires the uninstall webhook. All remaining event / alert / session data is permanently purged within 48 hours — well before Shopify's GDPR shop/redact deadline.