WooCommerce plugin docs / Cart Recovery

Cart Recovery settings

Navigation: WordPress Admin → WooCommerce → AI Assistant → Cart RecoverySettings

Abandoned-cart emails. Default: Off. Guest carts without an email cannot be emailed. Customer emails are masked in the admin table.

WP-Cron event aiwsa_cart_recovery uses a custom recurrence (default every 15 minutes). Daily cleanup also purges old recovery rows.

Licence: Core always allows basic recovery. Extra campaign steps (email #2/#3) and some AI log UI can be licence-filtered (cart_recovery_campaigns, cart_recovery_ai, etc.). Without a licence plugin they default on.


Enable abandoned cart recovery

What it does Tracks carts in the background and sends reminder emails after the threshold.

Default value Off.

Available options On / Off.

Recommended configuration On only after you configure From email, templates, and consent.

When to use it Stores that already collect checkout emails.

Effect on the frontend Optional checkout checkbox if Require marketing consent is on. Recovery links use signed query args aiwsa_recover and aiwsa_unsub.

Dependencies WP-Cron, WordPress/wp_mail (filter aiwsa_cart_recovery_mailer).

Important notes Not a full ESP (Mailchimp, Klaviyo) replacement.

Example On with 60-minute threshold.


Abandonment threshold (minutes)

What it does Minimum idle time after last cart activity before email #1.

Default value 60

Available options 510080

Recommended configuration 60

When to use it Longer for B2B quote carts.

Effect on the frontend When the reminder arrives.

Dependencies Enable recovery.

Important notes Cron interval also affects how soon a due email is sent.

Example 60


Minimum cart value

What it does Skip low-value carts.

Default value 0

Available options Numeric string (store currency).

Recommended configuration Your smallest profitable order, or 0.

When to use it Avoid emailing empty-ish carts.

Effect on the frontend None until email.

Dependencies Eligibility filter aiwsa_cart_recovery_cart_eligible.

Important notes Compared to WooCommerce cart total.

Example 50


Campaign duration (days)

What it does How long a cart stays in the campaign window.

Default value 7

Available options 190

Recommended configuration 7

When to use it Shorter for perishable inventory.

Effect on the frontend Stop sending after this window.

Dependencies None.

Important notes Separate from data retention.

Example 7


Maximum emails per cart

What it does Cap on reminder emails.

Default value 1

Available options 13 if campaigns are allowed; otherwise max 1.

Recommended configuration 1 until templates are proven.

When to use it 23 for a gentle sequence.

Effect on the frontend Inbox volume.

Dependencies Feature gate cart_recovery_campaigns.

Important notes Must enable email #2/#3 toggles as well.

Example 1


Enable AI-generated recovery messages

What it does Ask the configured LLM to write copy. Falls back to the template if AI is unavailable.

Default value Off.

Available options On / Off.

Recommended configuration Off until templates look right; then On for variety.

When to use it When you want unique subject/body per cart.

Effect on the frontend Email wording. Cart restore still uses signed links.

Dependencies API key. Prompt filter aiwsa_cart_recovery_prompt.

Important notes Test email checkbox: “Use AI generation (falls back to the template if AI is unavailable)”.

Example Off + solid template for compliance-heavy shops.


Tone (recovery AI)

What it does Tone hint for generated copy.

Default value friendly

Available options professional, friendly, conversational, premium, minimal, persuasive

Recommended configuration friendly or professional.

When to use it With AI generation On.

Effect on the frontend Email style.

Dependencies AI recovery On.

Important notes Not the same list as Chatbot tone.

Example professional


Custom AI instructions / Email #2 / #3 instructions

What it does Extra prompt text (max 2000). Example in admin: keep tone friendly; never use aggressive sales language.

Default value Empty.

Recommended configuration Short policy rules.

Dependencies AI generation.

Example Never offer discounts the store has not authorized.


Store AI generation logs

What it does Stores provider, model, time, and status. Does not store prompts, keys, or email bodies.

Default value Off.

Available options On / Off.

Recommended configuration On briefly while testing.

When to use it Debug failed AI copy.

Effect on the frontend None. Admin AI log subnav.

Dependencies Feature gate cart_recovery_ai_log.

Important notes Clear logs is a destructive admin-post action.

Example On for one week after launch.


Enable email #2 / #3

What it does Follow-up reminders.

Default value Off.

Delay defaults #2: 24 hours after abandonment (1336). #3: 48 hours.

AI for email #2/#3 Default On (used only if that step is enabled and AI recovery is available).

Recommended configuration Leave Off until email #1 is stable.

Dependencies Max emails ≥ step number; campaigns allowed.


From name / From email

What it does Mail headers. Empty uses WordPress defaults.

Default value Empty.

Recommended configuration A mailbox you monitor (store@yourdomain.com).

Dependencies Your host’s mail / SMTP plugin.

Important notes SPF/DKIM are hosting concerns, not this plugin.


Subject template / Header / Body template / CTA text / Footer

What it does Manual email content when AI is off or fails.

Default value Empty (plugin template renderer still has built-in structure; fill these for brand control).

Placeholders (subject): {{store_name}} {{product_name}} {{cart_total}}

Placeholders (body): {{cart_items}} {{cart_total}} {{recovery_message}} {{cart_url}} {{unsubscribe_url}} {{customer_name}} {{product_name}} {{product_url}} {{store_name}}

Filters: aiwsa_cart_recovery_subject, aiwsa_cart_recovery_body.

Recommended configuration Write a complete body including unsubscribe.

CTA text Button label.


Store logo / Brand color

What it does Email branding. Logo is a media attachment. Color is hex.

Default value None / empty.


Recovery link destination

What it does Where aiwsa_recover sends the shopper after restoring the cart.

Default value cart

Available options Cart, Checkout, Custom URL.

Custom redirect URL Used when destination is Custom. Filter aiwsa_cart_recovery_redirect.

Recommended configuration Cart, so shoppers review lines before paying.


Require marketing consent

What it does Adds a checkout checkbox: *Email me a reminder if I leave items in my cart.* Recovery emails are not sent without it. Also hooks WooCommerce Store API / Checkout Blocks customer update.

Default value On.

Available options On / Off.

Recommended configuration On.

When to use it Off only if you have another lawful basis and understand the risk. This plugin does not give legal advice.

Effect on the frontend Classic checkout billing checkbox; blocks checkout field registration when enabled.

Dependencies Cart recovery enabled.

Important notes Consent is not inferred from elsewhere.

Example On for EU-facing stores.


Data retention (days) (recovery)

What it does Abandoned-cart row retention (abandoned_carts type).

Default value 90

Available options 7730

Recommended configuration 90

Admin: Delete all tracking data is a separate destructive action on this card.


Batch size

What it does How many emails one cron run may send.

Default value 25

Available options 550

Recommended configuration 25

When to use it Lower on hosts with tight wp_mail limits.


Cron interval (minutes)

What it does WP-Cron schedule aiwsa_cart_recovery.

Default value 15

Available options 560

Recommended configuration 15

Important notes WP-Cron depends on traffic unless you use a real cron to wp-cron.php.


Debug logging

What it does Extra recovery debug logs.

Default value Off.

Recommended configuration Off.


Test email / Preview

On the Email card (not stored settings): send a test to an address you type, optionally with AI generation; Preview renders the template. AJAX: aiwsa_recovery_preview, aiwsa_recovery_test_email (manage_woocommerce).