Skip to main content

Configuration

This guide covers how to configure Live Carts for WooCommerce to meet your specific needs.

Table of Contents​

Basic Settings​

Navigate to BerryPress → Live Carts → Settings to configure basic options:

Frontend Options​

Display Cart ID​

Toggle visibility of cart IDs on cart pages

  • When enabled, customers can see their unique cart identifier
  • Useful for support purposes

Privacy Controls​

Collect IP Addresses​

Enable/disable IP address tracking

  • Can be disabled for enhanced privacy

Track Page URLs​

Enable/disable URL tracking

  • Tracks the last page viewed before cart abandonment
  • Useful for understanding customer journey
  • Can be disabled for enhanced privacy

Debug and Logging​

Debug Mode​

Enable detailed logging for troubleshooting

Log File Location File: wp-content/plugins/live-carts-for-woocommerce/debug-<TOKEN>.txt <TOKEN> is a random identifier generated when debug mode is enabled.

Pro Version Configuration​

Activation Management​

Navigate to BerryPress → Live Carts → Activation to manage your Pro activation.

Pro Features​

Cart Editing:

  • All cart editing is performed directly in the cart detail view
  • Changes are automatically saved to both database and active sessions
  • No additional configuration required

Recovery URLs:

  • Automatically generated
  • 32-character unique keys ensure security

Order Creation:

  • Available for any non-converted cart
  • Creates a pending WooCommerce order with cart contents
  • Marks original cart as "converted" after order creation

Cart Filtering:

  • Click "Show Filters" in the cart list to access advanced filtering
  • Contains product - Find carts with specific products (multi-select)
  • User - Filter by customer (multi-select)
  • Min cart value - Minimum cart total amount
  • Max cart value - Maximum cart total amount
  • Combine multiple filters for precise cart discovery

Cart Revision Tracking:

Navigate to BerryPress → Live Carts → Settings to toggle cart revision tracking.

  • Enable cart revisions - Track all cart content changes (enabled by default)
  • When enabled, view complete history of cart modifications in cart detail view
  • Shows added/removed products and quantity changes with timestamps
  • Disable to reduce database storage if revision history is not needed

User Role Exclusions:

Navigate to BerryPress → Live Carts → Settings to exclude user roles from tracking.

  • Do not track carts for users with role - Checkboxes for all WordPress roles
  • Exclude administrators, shop managers, or custom roles
  • Useful for preventing internal testing carts from appearing in reports
  • Selected roles will not have their carts tracked by the plugin

Client IP Header:

Navigate to BerryPress → Live Carts → Settings to configure it.

  • Specify a custom HTTP header for retrieving client IP addresses
  • Useful when your site is behind a proxy, load balancer, or CDN
  • Common headers include:
    • X-Forwarded-For - Standard proxy header
    • CF-Connecting-IP - Cloudflare-specific header
    • X-Real-IP - Nginx proxy header
  • Leave empty to use the default server IP detection
  • Only takes effect when "Collect IP Addresses" is enabled in Privacy Controls

Cart Details:

Navigate to BerryPress → Live Carts → Settings to configure cart detail display options.

  • Show Product Weight in Cart Details - Display the weight of each product in the cart items table
  • Disabled by default
  • When enabled, product weight will be shown alongside other product information in the admin cart details view
  • Useful for stores that need to track shipping weight or inventory logistics

Recovery Emails (Pro) - Coming Soon​

Coming Soon

This feature is currently in development and will be available in an upcoming release.

Automated cart recovery campaigns to help recover lost sales through timely reminders and optional discount incentives.

Overview​

Recovery Emails automatically send personalized emails to customers who abandon their carts, helping recover lost sales through timely reminders and optional discount incentives.

Creating Recovery Email​

  1. Click "Add New Email" or "Create First Recovery Email"
  2. Configure email settings:

Email Subject:

  • Supports shortcodes for personalization
  • Example: [first_name], you left items in your cart!

Email Body:

  • Full HTML editor with formatting options
  • Supports shortcodes and inline CSS for email clients
  • Use WordPress editor tools for rich content

Send Email After:

  • Set trigger time: value + unit (minutes/hours/days)
  • Example: 24 hours after cart last seen
  • Email sends when cart inactive for this duration

Discount Percentage:

  • Optional: 0-100%
  • If > 0, auto-generates unique WooCommerce coupon
  • Coupon valid for 7 days, single-use only
  • Leave 0 for no discount

Status:

  • Draft (Inactive) - Saved but not sending
  • Active - Live and will send to eligible carts

Shortcodes​

Use in subject or body for personalization:

  • [first_name] - Customer's first name (or "Customer" if unknown)
  • [cart_contents] - Formatted product list with images, quantities, and prices
  • [coupon] - Auto-generated coupon code (only shown if discount set)
  • [cart_url] - One-click cart recovery link

Example Email​

Subject:

[first_name], you forgot something in your cart!

Body:

<p>Hi [first_name],</p>

<p>We noticed you left some items in your shopping cart:</p>

[cart_contents]

<p>Complete your purchase now and use code <strong>[coupon]</strong> to save 10% on your order!</p>

<p><a href="[cart_url]">Click here to complete your purchase</a></p>

<p><small>This offer expires in 7 days.</small></p>

Email Sequence Strategy​

Recommended 3-email sequence:

EmailSend AfterDiscountPurpose
#11 hour0%Gentle reminder
#224 hours5-10%Incentive offer
#33 days10-15%Last chance

How It Works​

  1. Hourly Check - WordPress cron runs every hour
  2. Cart Matching - Finds carts matching each email's time threshold
  3. Eligibility - Only sends if email not previously sent to that cart
  4. Personalization - Replaces shortcodes with actual data
  5. Coupon Generation - Creates WooCommerce coupon if discount set
  6. Email Send - Delivers via WordPress wp_mail()
  7. Tracking - Records sent email to prevent duplicates

Email Management​

List View:

  • Shows all recovery emails (Active and Draft)
  • Columns: Subject, Send After, Discount, Status, Actions
  • Edit or Delete emails from list
  • Status indicator (Active/Draft)

Best Practices:

  • Test emails before setting to Active
  • Start with small discount (5%) and increase in later emails
  • Keep subject lines under 50 characters
  • Use urgency ("limited time", "expires soon")
  • Always include clear call-to-action button
  • Make cart_url prominent and easy to click

Troubleshooting​

Emails not sending:

  • Verify email status is "Active" (not Draft)
  • Check WordPress cron is working (use WP Crontrol plugin)
  • Test server can send emails (try WP Mail SMTP plugin)
  • Confirm cart meets time threshold
  • Check email wasn't already sent to that cart

Shortcodes not replacing:

  • Ensure exact syntax: [shortcode] not {shortcode}
  • Verify email is published and saved
  • Check for typos in shortcode names

Coupons not generating:

  • Verify discount percentage > 0
  • Check WooCommerce is active and working
  • Ensure you can manually create coupons in WooCommerce

Data Retention Settings​

Cart Status Management​

Navigate to BerryPress → Live Carts → Settings to configure cart status and archiving options.

Live Carts provides automatic status management and archiving of inactive carts to help with cart recovery campaigns, maintain database performance, track abandonment analytics, and manage the cart data lifecycle.

Default Values

By default, carts are automatically marked as abandoned after 2 hours of inactivity and archived after 30 days. The settings below allow you to override these default behaviors with custom timeframes.

Mark Carts as Abandoned After Hours​

Automatically mark carts as abandoned after a specified period of inactivity

  • Set the number of hours (e.g., 1, 2, 4, 24)
  • Overrides the default 2-hour abandonment threshold
  • Changes cart status from "Active" to "Abandoned"
  • Essential for tracking cart abandonment rates
  • Leave empty or set to 0 to use the default 2-hour setting

Archive Inactive Carts After Days​

Automatically archive carts that have been inactive for a specified number of days

  • Set the number of days (e.g., 7, 14, 30)
  • Overrides the default 30-day archiving period
  • Archived carts are hidden from the admin cart list but remain in the database
  • Useful for long-term cart data management and compliance with data retention policies
  • Leave empty or set to 0 to use the default 30-day setting
Best Practices
  • Set the abandonment threshold (hours) based on your typical checkout duration - most stores use 1-4 hours
  • Use the archiving setting (days) to clean up old cart data while maintaining records for analytics
  • A common configuration is: 2 hours for abandonment, 30 days for archiving
  • Consider your cart recovery strategy when setting the abandonment threshold