Home/Documentation/User Manual & Guide
Chrome Web Store Extension • Version 1.0.1

Checkout Detective User Guide

Everything you need to know to audit your Shopify checkout, eliminate duplicate Meta Pixel conversions, catch missing GA4 purchases, and protect your store's conversion rate.

1Chrome Installation & Setup

Install Checkout Detective directly from the Chrome Web Store in under 30 seconds.

Checkout Detective is distributed as a certified Google Chrome Extension (Manifest V3). It runs seamlessly on Google Chrome, Brave, Microsoft Edge, Arc, and any Chromium-based desktop browser.

1

Add to Chrome

Visit the Chrome Web Store and click Add to Chrome.

2

Pin to Toolbar

Click the Extension puzzle piece icon in Chrome toolbar and click the Pin icon next to Checkout Detective.

3

Launch on Store

Navigate to any Shopify store and click the icon to open the popup, or press F12 for DevTools.

2Mode 1: Quick Store Scan (< 2 Seconds)

Instantly check your storefront health, theme architecture, cart system, and active pixels without clicking through checkout.

When you open the extension popup on any page, you can click Quick Scan Store. In under two seconds, the diagnostic engine performs an immediate static audit:

What Quick Scan Inspects:

Platform & Theme Architecture

Verifies Shopify Online Store 2.0 readiness, theme markers (Dawn, Prestige, Impulse), and custom apps.

Cart System Detection

Identifies whether your store uses an Ajax Slide Cart Drawer, modal popup, or standard page redirect.

Checkout Button Health

Checks if the checkout button is visible, clickable, enabled, and linked correctly to /checkout.

Active Marketing Pixels

Detects Meta Pixel (fbq) and Google Tag (gtag / dataLayer) presence.

3Mode 2: Checkout Journey Investigation (The Core Workflow)

Simulate a real customer purchase while Checkout Detective records network calls, tracking events, and button behaviors.

This is the most powerful diagnostic mode for store owners. It validates whether real shoppers can seamlessly buy from your store without hidden JavaScript freezes or tracking drops:

How to Run an Investigation:

  1. Start the Session: Open the extension popup or Side Panel and click Start Checkout Investigation. The extension badge will pulse red (REC).
  2. Browse to a Product: Open any product page. The extension records the product view and checks for ViewContent telemetry.
  3. Click Add to Cart: Click Add to Cart. Checkout Detective inspects the /cart/add.js network response time and checks for duplicate AddToCart pixel fires.
  4. Open Cart & Click Checkout: Open your cart drawer and click the Checkout button. The extension checks if navigation is blocked or delayed by third-party upsell apps.
  5. Proceed Through Checkout: Fill in test shipping information. On development stores or staging stores, you can test with Shopify Bogus Gateway to simulate an order.
  6. Click Finish & View Diagnosis: Click Finish in the extension popup to view your 100-Point Store Health Score, the 7-Stage Funnel breakdown, and plain-English recommendations.

4The 7-Stage Conversion Funnel Explained

Understanding what each step in the Checkout Funnel Stepper means for your store.

✓ Completed

The stage was completed naturally with zero blocking errors, healthy network latency, and accurate tracking pixel events.

⚠ Warning

The customer reached this step, but non-fatal issues were detected (such as duplicate pixel fires, high network latency >2500ms, or missing parameter values).

✗ Failed

A hard blockage occurred. A JavaScript runtime crash prevented button navigation, or the cart API returned an HTTP 422 or 500 error.

? Not Detected

The customer stopped or abandoned the investigation before completing this step.

5Understanding Your Store Health Score (0–100)

A mathematical measurement of checkout stability and conversion tracking health.

At the end of an investigation, Checkout Detective calculates an authoritative 0–100 score across five weighted categories:

Checkout Flow30 pts

Funnel progression & button response

Pixel Tracking25 pts

Meta & GA4 accuracy & duplicate check

Network Health20 pts

Cart APIs & gateway response times

JS Stability15 pts

Click-to-error correlation & exceptions

Apps & Speed10 pts

App script vendor load & failures

90 – 100🟢 Excellent Health
75 – 89🟡 Good Health
60 – 74🟠 Fair (Leaks Detected)
0 – 59🔴 Critical Attention

6Using the Chrome DevTools Panel & Side Panel

Open deep developer-level telemetry without leaving your Chrome browser.

Press F12 (or right-click anywhere and select Inspect) and click the Checkout Detective tab. You will access 7 specialized tabs:

1. Summary Tab

Executive dashboard featuring the 100-point health score gauge, 7-stage checklist, and priority action cards.

2. Unified Timeline

Chronological feed of customer clicks, network calls, console logs, and pixel fires with precise millisecond timestamps.

3. Pixel Detective Tab

Side-by-side comparison of Meta Pixel and GA4 events. Automatically flags duplicate fires occurring within 2.0 seconds.

4. Network Waterfall

Visual HAR waterfall displaying cart API latencies, HTTP 422 variant rejections, tracking blocks, and payment timeouts.

5. Correlated Console Errors

Connects JavaScript runtime exceptions directly to button clicks occurring within 1500ms.

6. Third-Party Script Profiler

Catalogs external apps (Klaviyo, Yotpo, Loox, Recharge, Gorgias) and calculates their checkout performance impact.

7The 50 Diagnostic Rules & Store Fix Guide

50 Searchable Rules

Search or filter the deterministic rules evaluated by Checkout Detective to see exact explanations and how to fix them in Shopify Admin or your theme.

Showing 50 of 50 diagnostic rules
CHK-001

Purchase Missing After Checkout

Checkout FlowCritical

Checkout was initiated and reached the final payment step, but no completed purchase event was detected on order confirmation.

Store Fix:In Shopify Admin > Settings > Customer Events, ensure your marketing app or custom web pixel has permissions for checkout_completed. Verify your thank-you page loads cleanly.
CHK-002

Checkout Button Clicked But No Navigation

Checkout FlowCritical

The customer clicked the checkout button, but the store failed to redirect to checkout.

Store Fix:Inspect your cart drawer in Online Store > Themes. Ensure the checkout button form action points to /checkout with method POST and no installed app cancels the click with event.preventDefault().
CHK-003

Add to Cart Failed to Update Cart Count

Checkout FlowWarning

Add to Cart action occurred, but the cart item count badge remained at 0.

Store Fix:Check your theme cart listener. Verify that your theme updates the cart badge UI automatically after the /cart/add.js response succeeds.
CHK-004

Cart Drawer Failed to Open

Checkout FlowWarning

Add to Cart completed successfully, but the slide cart drawer or popup modal failed to appear.

Store Fix:Audit newly installed apps (like free shipping progress bars or upsell modals) to ensure they do not detach your theme cart drawer event listeners.
CHK-005

Checkout URL Missing Session Parameters

Checkout FlowWarning

Redirected to checkout but checkout session tokens or security parameters were stripped.

Store Fix:Ensure checkout redirection originates from a native POST to /cart or /checkout without intermediate custom redirects that discard tokens.
CHK-006

Abandoned at Payment Step

Checkout FlowInfo

Investigation concluded after reaching the payment screen without placing a real order.

Store Fix:Normal test behavior when stopping an audit prior to entering live payment credentials.
CHK-007

Rapid Successive Checkout Clicks

Checkout FlowWarning

Customer clicked the checkout button repeatedly in under 1 second due to a missing loading state.

Store Fix:Add a visual loading spinner or temporarily disable the checkout button immediately upon first click to prevent duplicate submissions.
CHK-008

Direct Checkout Bypass Without Cart Session

Checkout FlowWarning

Checkout started directly from a Buy Now button without passing through the cart.

Store Fix:Ensure Buy Now buttons serialize custom line item properties and discount codes properly into the direct checkout URL.
CHK-009

Out of Stock Checkout Halting

Checkout FlowWarning

Checkout progression stopped because an item in the cart is depleted in inventory.

Store Fix:Ensure your product page swatches and option selectors automatically disable the Add to Cart button when a variant is out of stock.
CHK-010

Zero Dollar Order Freezing

Checkout FlowWarning

Cart total is $0.00 (e.g. 100% discount code) and checkout hung during payment setup.

Store Fix:Verify Shopify Admin checkout settings to confirm zero-dollar orders bypass credit card processing automatically.
PIX-011

Meta Pixel AddToCart Duplicate

Meta PixelCritical

Meta Pixel fired AddToCart 2 or more times for a single click within 2.0 seconds.

Store Fix:Check theme.liquid for legacy fbq("track", "AddToCart") snippets that compete with the official Facebook & Instagram app or Shopify Customer Events.
PIX-012

Meta Pixel Purchase Duplicate

Meta PixelCritical

Meta Pixel Purchase event fired multiple times for this single order, doubling reported ROAS.

Store Fix:Ensure browser fbq and Server Conversions API (CAPI) send matching event_id parameters so Meta Ads Manager deduplicates the order.
PIX-013

Meta Pixel Not Detected

Meta PixelWarning

No Meta Pixel was detected on the store or ad-blockers blocked the tracking tag.

Store Fix:Connect the official Meta app in Shopify Admin or configure a Custom Web Pixel under Customer Events.
PIX-014

Meta InitiateCheckout Missing

Meta PixelCritical

Customer entered checkout, but Meta Pixel InitiateCheckout event did not fire.

Store Fix:Verify customer privacy cookie banners do not suppress marketing consent on checkout pages prior to user approval.
PIX-015

Meta Purchase Value Missing or Zero

Meta PixelWarning

Meta Purchase event fired without a valid monetary value or currency code.

Store Fix:Ensure checkout.subtotal_price or checkout.total_price is passed as a numerical float with ISO currency (e.g. USD, EUR).
PIX-016

Multiple Meta Pixel IDs Detected

Meta PixelWarning

More than one distinct Meta Pixel ID is firing events simultaneously on the storefront.

Store Fix:Check theme.liquid and app embeds to remove orphaned pixel tags left behind by previously uninstalled marketing apps.
PIX-017

Meta ViewContent Missing on Product Page

Meta PixelInfo

Product page was visited but Meta ViewContent did not fire.

Store Fix:Ensure your product template or Customer Events pixel subscribes to product_viewed and emits ViewContent.
PIX-018

Meta Pixel Network Call Blocked

Meta PixelCritical

Meta tracking requests to facebook.com/tr were blocked by browser security or ad-blockers.

Store Fix:Audit store Content-Security-Policy (CSP) headers to ensure connect-src permits facebook.com and connect.facebook.net.
GA-019

GA4 Duplicate add_to_cart

Google TrackingCritical

Google Analytics received multiple add_to_cart events for a single click.

Store Fix:Audit GTM triggers. Ensure custom dataLayer.push is not firing concurrently with Shopify native Google & YouTube app tracking.
GA-020

GA4 begin_checkout Missing

Google TrackingCritical

Customer entered checkout, but GA4 begin_checkout event was not recorded.

Store Fix:Configure Shopify Customer Events Web Pixels to subscribe to checkout_started and push begin_checkout to GA4.
GA-021

GA4 Purchase Missing on Order Success

Google TrackingCritical

Order confirmation was reached, but GA4 purchase event was missing.

Store Fix:Ensure Google Consent Mode v2 analytics_storage is granted and subscribe to checkout_completed in Customer Events.
GA-022

GTM DataLayer Missing or Overwritten

Google TrackingWarning

window.dataLayer was reset or initialized incorrectly as an object instead of an array.

Store Fix:Always initialize with window.dataLayer = window.dataLayer || []; never overwrite with dataLayer = {}.
GA-023

GA4 Transaction ID Missing in Purchase

Google TrackingWarning

GA4 purchase event emitted without a unique transaction_id parameter.

Store Fix:Map transaction_id to event.data.checkout.order.id or fallback to checkout.token to prevent dropped monetization metrics in GA4.
GA-024

Google Ads Conversion Tag Missing Currency

Google TrackingWarning

Google Ads conversion event lacks currency code parameter.

Store Fix:Include currency parameter (e.g. currency: "USD") on all gtag conversion calls.
GA-025

Multiple Google Measurement IDs Detected

Google TrackingInfo

Multiple Google Analytics Measurement IDs (G-XXXXX) are loaded simultaneously.

Store Fix:Consolidate multiple GA4 streams into a single measurement ID to prevent bloated browser memory and duplicate reporting.
GA-026

GA4 Items Array Empty on Checkout

Google TrackingWarning

GA4 begin_checkout was sent with an empty items: [] array.

Store Fix:Format line items according to GA4 ecommerce schema: item_id, item_name, price, quantity, item_brand, item_category.
NET-027

Cart API Returned HTTP 422

Network & APICritical

Shopify Cart endpoint returned HTTP 422 Unprocessable Entity.

Store Fix:Check variant inventory level, ensure quantity is > 0, and verify all required custom line item properties are populated.
NET-028

Cart API Returned HTTP 500

Network & APICritical

Shopify Cart endpoint returned HTTP 500 Internal Server Error.

Store Fix:Review theme app extensions or backend webhook proxies modifying cart data during cart mutations.
NET-029

Tracking Endpoint Returned HTTP 403

Network & APIWarning

Analytics or tracking server returned HTTP 403 Forbidden.

Store Fix:Check store domain verification in Meta Business Manager and verify domain is allowlisted in Google Analytics.
NET-030

Payment Session API Timeout

Network & APICritical

Payment gateway or checkout session timed out (>5000ms latency).

Store Fix:Test payment gateway connectivity (Shopify Payments, PayPal, Stripe) and audit third-party fraud or tax calculating apps.
NET-031

Network Request Blocked by Client / CSP

Network & APICritical

A critical checkout or tracking request was blocked by browser security policy.

Store Fix:Audit HTTP Content-Security-Policy headers in theme or Cloudflare dashboard to ensure checkout endpoints are permitted.
NET-032

High Latency on Cart Mutation (>2500ms)

Network & APIWarning

Cart operation took longer than 2.5 seconds to complete.

Store Fix:Optimize third-party app hooks that intercept /cart/change.js (e.g. tiered discount calculators or automatic gift apps).
NET-033

Cross-Origin CORS Error on Cart Endpoint

Network & APICritical

Cart request was blocked due to missing Access-Control-Allow-Origin.

Store Fix:Ensure headless frontends proxy cart requests through Storefront API with valid public access tokens.
NET-034

Currency Conversion API Failed

Network & APIWarning

Currency conversion service failed to respond with exchange rates.

Store Fix:Ensure Shopify Markets native multi-currency rounding is used instead of client-side scraping scripts.
JS-035

JS Error Correlated with Checkout Click

JavaScriptCritical

A JavaScript runtime error occurred within 1500ms of clicking Checkout.

Store Fix:Check DevTools Console for TypeError or undefined property in theme.js or cart app scripts during button click event.
JS-036

JS Error Correlated with Add to Cart

JavaScriptCritical

A JavaScript runtime error occurred immediately when adding an item to cart.

Store Fix:Verify form serialize logic. Ensure variant ID input selector exists and handles swatch option changes cleanly.
JS-037

preventDefault Called Without Redirect

JavaScriptCritical

An event listener prevented checkout form submission but failed to trigger manual redirect.

Store Fix:Audit third-party cart apps that hijack the submit event. Ensure fallback window.location = "/checkout" is called on failure.
JS-038

Uncaught Promise Rejection in Cart Flow

JavaScriptWarning

An unhandled asynchronous Promise rejection occurred in the browser.

Store Fix:Wrap fetch("/cart/add.js") and async theme methods in try/catch blocks with graceful user error notifications.
JS-039

Checkout Button Disabled After Single Click

JavaScriptWarning

Checkout button remained disabled permanently without navigating.

Store Fix:Reset button state in a finally block if the cart validation network request fails or times out.
JS-040

jQuery or Theme Global Undefined

JavaScriptWarning

A script threw "$ is not defined" or "Shopify is not defined".

Store Fix:Ensure dependent scripts are loaded with defer after theme vendor libraries, or refactor legacy scripts to modern vanilla JavaScript.
JS-041

Conflicting Event Listeners on Button

JavaScriptWarning

More than 3 separate click listeners are bound to the checkout button.

Store Fix:Consolidate multiple app listeners using event delegation on the document or cart container.
JS-042

High Error Frequency During Checkout

JavaScriptCritical

More than 5 distinct JavaScript errors fired during this checkout session.

Store Fix:Audit theme for deprecated Liquid variables or missing app assets creating high-frequency console loops.
SES-043

UTM Parameters Dropped at Checkout Transition

Session & UTMWarning

Marketing campaign UTM parameters were lost during navigation to checkout.

Store Fix:Persist utm_source, utm_medium, utm_campaign, and gclid in sessionStorage and append to /checkout?utm_... link.
SES-044

Currency Mismatch Between Catalog and Cart

Session & UTMWarning

Currency displayed on product page differs from currency passed to cart or checkout.

Store Fix:Ensure Shopify Markets currency selector updates both theme localized price attributes and cart currency.
SES-045

Discount Code Lost on Redirect

Session & UTMWarning

Discount applied in cart was not carried over to checkout URL.

Store Fix:Append ?discount=CODE to checkout redirect URL when user enters coupon code in slide cart drawer.
SES-046

Language Code Mismatch on Localized Store

Session & UTMInfo

Store locale shifted unexpectedly during checkout navigation.

Store Fix:Prefix checkout URL with locale path (e.g. /fr/checkout or /de/checkout) matching current browser session.
APP-047

Excessive Third-Party Vendors (>15 Vendors)

Apps & PerfWarning

Store loads more than 15 distinct third-party services during checkout.

Store Fix:Uninstall unused apps from Shopify Admin and audit theme.liquid to purge orphaned tracking tags and widgets.
APP-048

Third-Party App Script Failed to Load (404/500)

Apps & PerfWarning

An external app script returned HTTP 404 or 500 error.

Store Fix:Remove legacy script tags pointing to defunct third-party app CDNs that block browser parser threads.
APP-049

High Impact Third-Party App Latency

Apps & PerfWarning

Third-party app script generated multiple errors and latency.

Store Fix:Defer non-essential widgets (reviews, social proof popups) until after window load event.
APP-050

Render-Blocking Script Slowing Checkout Transition

Apps & PerfWarning

A third-party script delayed navigation or page rendering by over 1.5 seconds.

Store Fix:Add async or defer attributes to all third-party analytics and chat widget script tags in theme.liquid.

8Zero-PII Privacy & Security Guarantee

Why Checkout Detective is 100% safe to use on live, production checkout flows.

Testing checkout journeys often requires entering names, addresses, or test cards. To keep your store and customers completely safe, Checkout Detective enforces strict client-side data isolation:

Credit Card & CVV Redaction

Automatically detects and masks credit card patterns to tokens like [REDACTED_CARD_ending_XXXX]. CVV codes and passwords are never recorded.

Customer Email & Address Isolation

Personal identifiers like email addresses, phone numbers, and street addresses are stripped from diagnostic logs before memory storage.

100% Local In-Browser Execution

We do not run tracking databases or remote collection servers. All diagnostic evaluations run purely inside your Chrome browser.

Instant Memory Clearing

Clicking "Reset Investigation" or closing the browser tab immediately clears all temporary diagnostic records from local browser memory.

9Exporting Reports & Sharing with Developers

Deliver clear, actionable evidence to your agency, freelance developer, or Shopify Support.

Standalone HTML Audit Report

1-Click

Downloads a self-contained offline HTML file with embedded styling. Includes your 100-point score, the 7-stage checklist, and plain-English recommendations. You can open it in any browser or print to PDF using Ctrl+P.

Markdown Bug Ticket

Clipboard

Copies a pre-formatted bug ticket directly to your clipboard. Ready to paste into GitHub Issues, Jira, Asana, Linear, or a ticket to Shopify Partner Support with steps to reproduce and technical evidence.

10License Key & Upgrading to Pro

How to activate your LemonSqueezy license key to unlock unlimited store audits and agency exports.

Checkout Detective uses a Freemium model. You can run 5 free checkout investigations per month forever. When you require unlimited investigations, full HAR exports, and white-label agency reports, upgrade to Pro or Agency:

  1. Purchase a license key from our Pricing Plans page securely via LemonSqueezy.
  2. Your license key will be sent instantly to your email address.
  3. Open the Checkout Detective popup in Chrome and click the Settings (Gear) icon.
  4. Paste your license key into the License field and click Activate License.
  5. Your extension instantly upgrades to Pro or Agency mode across your browser sessions.

11Company Profile & Dedicated Support

About Proxibite, our engineering standards, and how to reach our technical team.

🏢

About Proxibite

Software Studio & E-Commerce Tooling
Verified Studio

Checkout Detective is a proprietary diagnostic software product developed, maintained, and operated by Proxibite. We build specialized browser extensions and developer tools that empower e-commerce merchants, digital agencies, and conversion engineers to eliminate checkout drop-offs, fix broken marketing pixels, and optimize store revenue.

Operating Studio:Proxibite
Core Expertise:Shopify & Plus Diagnostics, CRO DevTools
Payment Merchant:Lemon Squeezy (PCI-DSS Level 1)
Customer Guarantee:30-Day 100% Money-Back
✉️

Dedicated Support Desk

Direct Developer & Merchant Support
< 24h SLA

Have questions regarding an ongoing store audit, custom diagnostic rules, offline license key activation, or refund inquiries? Our engineers respond directly within 24 business hours.

Direct Email Address:contact@proxibite.com
General & Agency Inquiries:Visit Contact Page →

Install Checkout Detective Today

Catch broken checkout buttons, duplicate Meta pixels, and revenue leaks before they cost you orders. Free forever for boutique merchants.