Changelog

5.0.0 2026-11-18

{warning} Before upgrading to Abandoned Cart 5, review the Upgrading from v4 guide for breaking changes and required migration steps.

Added

  • Added sequences of up to five recovery emails, each with its own audience (cart value, returning customers, first-time customers, products or custom order rules), sites, timing and optional discount code. A default sequence, All Other Carts, catches every cart that no other sequence matches.
  • Added sequence presets, managed under Settings → Sequence Presets and kept in project config, and the Presets::EVENT_REGISTER_PRESETS event for adding, changing, reordering or removing them in code.
  • Added an email editor with tokens, a live preview using a sample cart in the store’s currency or a real cart, and test sends.
  • Added email templates, stored in project config, with a responsive bundled design that needs no template files and an option to copy it to your own templates.
  • Added the Overview, with recovered revenue, recovery rate, a recovery funnel, sequence and email performance, and a setup checklist for new installs. Carts from blocked domains are left out of its figures.
  • Added the Carts screen and cart pages, with each cart’s journey and history, skipped carts with their reasons, Send Now, Stop Emails and Retry actions, and a Can be emailed switch.
  • Added the Customers screen and customer pages, with Can be emailed, Unsubscribed and Do Not Email statuses, and an Abandoned Cart tab on Craft user accounts. Removing a customer from Do Not Email restores the status they had before, so an unsubscribed customer stays unsubscribed.
  • Added a Delete Customer action, which removes a customer and their cart history for erasure requests.
  • Added unsubscribe links and one-click List-Unsubscribe headers to every recovery email, with a confirmation page for customers.
  • Added craft.abandonedCart.getCurrentCustomer() and the abandoned-cart/preferences/save action, so signed-in customers can turn cart reminders off or on from their account.
  • Added the Consent Field, Blocked Domains, Only Returning Customers, Contact Limit, Attribution Window, Recovery Ends After and Pause All Sending settings, with per-sequence overrides for recovery timing and the return page.
  • Added a Page Template setting so expired-link and unsubscribe pages can render inside the site's layout.
  • Added System Status, which shows how the scheduler is being started, its last run and the last 24 hours of runs, the cron job to add, health checks for sending, recent failures, email templates and consent, and a Run Now action. It works where admin changes aren't allowed.
  • Added the Manage sequences and send emails, Manage Do Not Email, Delete customers and View System Status permissions.
  • Added events for sequences, emails, email templates, audiences, enrolment, consent, recovery links, sending, rendering and customers.
  • Added the compatibilityMode setting, on by default, which keeps the 4.x email template variables, the beforeMailSend event, the 4.x console command and the 4.x scheduler URL working while sites update. The event, command and URL log deprecation warnings.

Changed

  • Upgrading from 4.x runs a one-time migration that converts 4.x settings, reminders, templates and the blocklist into the default sequence, email templates, Do Not Email statuses and the new settings, and imports 4.x reminder history.
  • The scheduler command is now abandoned-cart/recoveries/run, and sends due emails itself rather than queueing a job for each email. When cron isn't available, web requests queue a run while a sequence is on.
  • Recovery links now restore carts that belong to an account only for that customer, after signing in, and show a page explaining expired or invalid links.
  • Recovery links now apply the email’s discount code to the restored cart, and the bundled email says so. Applying the code doesn’t count as a cart change, so the remaining emails keep their times.
  • When a customer abandons a newer cart, it now takes over the recovery of their older one, keeping its sequence and the times of its remaining emails.
  • Any order a customer completes now ends their recovery, even when it’s from a different cart, and counts as recovered when it comes within the attribution window after an email, with or without a click.
  • Failed emails are now retried automatically, up to three tries.
  • Abandoned Cart now requires Craft CMS 5.6 or later.

Deprecated

  • Deprecated the checkoutLink, discount and currentSite email template variables. Use recoverUrl, discountCode and site instead.
  • Deprecated Carts::EVENT_BEFORE_MAIL_SEND. Use Attempts::EVENT_BEFORE_SEND instead.
  • Deprecated the abandoned-cart/reminders/schedule-emails console command. Use abandoned-cart/recoveries/run instead.
  • Deprecated the abandoned-cart/carts/find-carts scheduler URL and the passKey setting. Use abandoned-cart/recoveries/run from cron instead.

Removed

  • Removed or replaced the firstReminderDelay, secondReminderDelay, firstReminderSubject, secondReminderSubject, firstReminderTemplate, secondReminderTemplate, discountCode, disableSecondReminder, restoreExpiryHours, recipientCooldownHours, staleRecordRetentionDays, recoveryUrl, previousOrderRequired, blacklist and includeBlacklisted settings. The upgrade guide maps each one to its replacement.
  • Removed the Carts::EVENT_BEFORE_SAVE_CART and Carts::EVENT_AFTER_SAVE_CART events, the CartEvent class and the 4.x cart model and record.
  • Removed the 4.x getCarts() and getService() plugin services and their methods.
  • Removed the bundled abandoned-cart/emails/first and abandoned-cart/emails/second email templates.