FAQ
General
Section titled “General”What is CartBay?
Section titled “What is CartBay?”CartBay is a WooCommerce abandoned cart recovery plugin. It captures consented checkout visitors, detects abandoned carts, sends a three-email recovery sequence, restores carts through secure links, and tracks recovered revenue.
Where do I manage CartBay?
Section titled “Where do I manage CartBay?”Open WooCommerce > CartBay or WooCommerce > Settings > Cart in WordPress admin.
Does CartBay use custom database tables?
Section titled “Does CartBay use custom database tables?”No. CartBay stores recovery sessions as WooCommerce order-backed sessions and uses WooCommerce CRUD APIs.
Does CartBay support WooCommerce Block Checkout?
Section titled “Does CartBay support WooCommerce Block Checkout?”Yes. CartBay supports classic checkout and WooCommerce Block Checkout. Block Checkout uses a WooCommerce additional checkout field in the contact section.
Capture
Section titled “Capture”Why is the consent checkbox not showing?
Section titled “Why is the consent checkbox not showing?”Check that Capture is enabled, WooCommerce is active, and you are viewing the checkout page rather than the order-received page.
What happens if a shopper unchecks consent?
Section titled “What happens if a shopper unchecks consent?”CartBay treats that as consent withdrawal. It deletes the active captured or abandoned session and cancels pending abandonment checks and recovery emails for that session.
Can one email have multiple active sessions?
Section titled “Can one email have multiple active sessions?”Yes. CartBay identifies carts by session ID and cart fingerprint, not email alone. One shopper can have multiple active CartBay sessions if the carts are materially different.
Recovery Emails
Section titled “Recovery Emails”When does the first recovery email send?
Section titled “When does the first recovery email send?”By default, Email 1 sends 45 minutes after the cart becomes abandoned. If the abandonment timeout is 30 minutes, that means Email 1 sends about 75 minutes after the shopper’s last captured activity.
What if Action Scheduler is delayed?
Section titled “What if Action Scheduler is delayed?”Pending recovery emails are not dropped. They run when Action Scheduler resumes, as long as CartBay’s send guards still allow the email.
What does Sent mean in Notifications?
Section titled “What does Sent mean in Notifications?”Sent means WordPress/WooCommerce accepted the email send. It does not guarantee inbox delivery unless a provider integration explicitly reports delivery.
SMTP or Email Services
Section titled “SMTP or Email Services”Do I need an SMTP plugin or email service?
Section titled “Do I need an SMTP plugin or email service?”CartBay can send through the normal WordPress/WooCommerce email system, but a dedicated SMTP plugin or transactional email service is strongly recommended for reliable inbox delivery.
Which email services can I use?
Section titled “Which email services can I use?”You can use any service that integrates with WordPress mail delivery, such as SMTP.com, Mailgun, Postmark, SendGrid, Amazon SES, Brevo, or your hosting provider’s SMTP service.
Does CartBay send emails directly through SMTP?
Section titled “Does CartBay send emails directly through SMTP?”No. CartBay hands recovery emails to WooCommerce and WordPress mail delivery. Your SMTP plugin or transactional email integration controls how those messages are sent.
Why do Notifications show Sent but customers do not receive emails?
Section titled “Why do Notifications show Sent but customers do not receive emails?”Sent means WordPress accepted the send request. Inbox delivery can still fail because of SMTP configuration, domain authentication, spam filtering, bounces, or provider limits. Check your email provider logs and WooCommerce logs.
What DNS records should I configure?
Section titled “What DNS records should I configure?”Configure the records recommended by your email provider, usually SPF, DKIM, and DMARC. These records help receiving inboxes trust recovery emails sent from your store domain.
Templates
Section titled “Templates”Where do I edit recovery emails?
Section titled “Where do I edit recovery emails?”Open WooCommerce > CartBay > Templates, then click Edit in WooCommerce for the recovery email you want to edit.
Which placeholders can I use?
Section titled “Which placeholders can I use?”Common placeholders include {site_title}, {customer_email}, {restore_url}, {coupon_code}, {coupon_expiry}, and {unsubscribe_url}. Coupon placeholders only resolve for coupon-enabled steps.
Why is my coupon placeholder empty?
Section titled “Why is my coupon placeholder empty?”The email step probably does not have coupons enabled. Enable coupons for that step in Recovery Sequence and configure the coupon in Offers.
Offers and Coupons
Section titled “Offers and Coupons”When are coupons generated?
Section titled “When are coupons generated?”Coupons are generated only for recovery email steps where Include a recovery coupon is enabled.
Can shoppers share recovery coupons?
Section titled “Can shoppers share recovery coupons?”CartBay-generated coupons are restricted to the recovery session and captured email. CartBay also validates coupon use against restored session identity.
Are coupons applied to subscription products?
Section titled “Are coupons applied to subscription products?”CartBay avoids applying recovery coupons when the cart contains WooCommerce Subscription products or subscription variations.
Licensing
Section titled “Licensing”Where do I get my license key?
Section titled “Where do I get my license key?”Your license key is sent in the purchase confirmation email. You can also retrieve it by logging in to your WPAnchorBay account dashboard at wpanchorbay.com.
Who should I contact for license help?
Section titled “Who should I contact for license help?”Contact support@wpanchorbay.com.
Will CartBay stop working if the license server is temporarily unavailable?
Section titled “Will CartBay stop working if the license server is temporarily unavailable?”No. CartBay fails open for license server network failures so capture, recovery emails, and restore flows continue running.
Data and Privacy
Section titled “Data and Privacy”Does CartBay store raw restore tokens?
Section titled “Does CartBay store raw restore tokens?”No. Restore and unsubscribe tokens are generated as opaque strings and stored as SHA-256 hashes.
What happens when a shopper unsubscribes?
Section titled “What happens when a shopper unsubscribes?”CartBay creates a suppression record, marks the session suppressed, and cancels pending recovery email work.
Can I delete CartBay data on uninstall?
Section titled “Can I delete CartBay data on uninstall?”Yes. Enable Delete Data on Uninstall in Settings before deleting the plugin. Leave it disabled if you may reinstall CartBay later.
Troubleshooting
Section titled “Troubleshooting”Why are emails queued but not sending?
Section titled “Why are emails queued but not sending?”Action Scheduler may not be running promptly. Check WooCommerce scheduled actions and server cron behavior.
Why did restore fail?
Section titled “Why did restore fail?”Common causes include expired tokens, deleted sessions, unavailable products, invalid cart snapshots, or cart validation failures.
Where are logs?
Section titled “Where are logs?”WooCommerce logs are available in WooCommerce > Status > Logs with source cartbay. CartBay also has a hidden CartBay Logs section linked from Settings.
AI Agents
Section titled “AI Agents”Is AI-agent access enabled by default?
Section titled “Is AI-agent access enabled by default?”No. Agent access is off by default and must be enabled in Settings.
Should I enable sensitive or destructive agent actions?
Section titled “Should I enable sensitive or destructive agent actions?”Only for trusted, least-privilege workflows that explicitly need them. Keep sensitive and destructive access disabled for general monitoring agents.