CartShield AI
Docs

Setup guide

Get CartShield AI live on your store in about ten minutes.

1. Install CartShield AI

Open the app's install URL or the Shopify App Store listing. Approve the consent screen. You'll land inside the embedded Shopify admin at /app.

2. Enable the theme app embed

  1. Online Store → Themes → Customize on your published theme.
  2. Open App embeds in the theme editor's left rail.
  3. Toggle on CartShield Widget.
  4. Save the theme.

3. Configure the app URL if needed

Inside the App Embed settings, paste the CartShield production app URL into the CartShield App URL field. The default points at the deployed app and should not need changes in production. Don't include a trailing slash.

4. Customize widget settings

Embedded admin → Widget. Edit the title, description, button label, success message, privacy text, brand color, border radius, and where the widget shows (product pages, cart page, after add-to-cart, exit intent). Save — the new settings take effect on the next storefront page load.

5. Configure sender email

Verify your sending domain in your email provider (Resend or Postmark) and set EMAIL_FROM to an address on the verified domain. Default sender on CartShield AI deployments is CartShield <no-reply@mail.cartshieldai.com>.

6. Set recovery email delays

Embedded admin → Recovery Emails. Each email in the sequence has its own delay (minutes after capture) and subject line. Plan limits cap the maximum number of emails per sequence.

7. Test cart capture

  1. Open your storefront in a fresh incognito window.
  2. Visit any product page.
  3. Add the product to cart.
  4. Submit your own email when the widget appears.
  5. Refresh the admin's Captured Carts page — the row should appear within seconds.

Append ?cartshield_debug=1 to any storefront URL for browser-console diagnostic logs.

8. Test recovery email delivery

Captured carts that pass risk checks queue up recovery emails. To force a send without waiting for the cron interval, use the Diagnostics page's "Run recovery email job once" action. Confirm delivery in your inbox and check the Recovery Emails queue counts (Scheduled / Sent / Failed / Cancelled).

9. Review captured carts and recovery emails

The Captured Carts table supports email search and multi-select filters by risk tier and recovery status. Each row links to a detail page showing the cart items, risk signals, and the email timeline. Blocked Carts shows everything filtered out by the risk engine.

10. Contact support

Stuck on any step? Email help@cartshieldai.com with your store URL and a description of what you're seeing. Including the browser console output from ?cartshield_debug=1 speeds up triage significantly.