Skip to content

Add commerce abandoned cart notification job #7200

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 11 commits into from
Jul 16, 2025
Merged
Show file tree
Hide file tree
Changes from 4 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions 16/umbraco-commerce/SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,7 @@
* [Use an Alternative Database for Umbraco Commerce Tables](how-to-guides/use-an-alternative-database-for-umbraco-commerce-tables.md)
* [Customizing Templates](how-to-guides/customizing-templates.md)
* [Configuring Cart Cleanup](how-to-guides/configuring-cart-cleanup.md)
* [Configuring Abandoned Carts Notification](how-to-guides/configuring-abandoned-cart-notification.md)
* [Limit Order Line Quantity](how-to-guides/limit-orderline-quantity.md)
* [Implementing Product Bundles](how-to-guides/product-bundles.md)
* [Implementing Member Based Pricing](how-to-guides/member-based-pricing.md)
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
---
description: Learn how to configure the abandoned cart notification.
---

# Configuring Abandoned Cart Notification

{% hint style="info" %}
Available from Umbraco Commerce 16.1.0
{% endhint %}

## Abandoned Cart Recurring Background Job

The abandoned cart recurring background job automatically sends reminder emails to customers about items left in their shopping carts. You can configure it using the steps below:
- Go to Store Settings in your admin dashboard.
- Select the store you want to configure.
- Scroll down to the Cart Settings section.
- Choose your Abandoned Cart Email Template. If the email template is not set, no notification will be sent but the webhooks can still be fired.
- Set the period of minutes that a cart must be inactive before it is deemed to be abandoned. If the value is 0, the abandoned cart detection is disabled.
- Enter the landing page URL for customers to be redirected to when they click on the links in the abandoned cart email.
- Click the Save button to apply your changes.

![store notification settings](images/configuring-abandoned-cart-notification/store-notification-settings.png)


The advanced settings can be configured in the `appsettings.json`

```json
{
"Umbraco" : {
"Commerce": {
"AbandonedCartNotifierService": {
"Enable": false, // Set to true if you want to enable the background job
"FirstRunTime": "", // Optional settings
"Period": "1.00:00:00", // Optional settings
"NotificationBatchSize": 20, // Optional settings
}
}
}
}
```

The `appsettings.json` section supports the following keys.

| Key | Description |
| -- | -- |
| `Enable` | Enable this feature.
| `FirstRunTime` | The time to first run the scheduled cleanup task, in crontab format. If empty, runs imediately on app startup. |
| `Period` | How often to run the task, in timespan format. Defaults to every 24 hours. |
| `NotificationBatchSize` | The number of abandoned carts processed each time the job is run. |

## Abandoned Cart Webhook
A new webhook called Cart Abandoned has been added. It is triggered when the Abandoned Cart Recurring Background Job detects any abandoned carts. The POST payload will look like this:
```json
{
"orderIds": [
"8b2cfad6-a0eb-4b87-ad86-019768ad1308",
"95aa34bd-8a01-45a4-9492-019768ac6c61",
"db9a2cc5-621a-40a3-9fab-019768a79d0a"
]
}
```

## Abandoned Cart Conversion Rates Widget

The widget shows how many notified abandoned carts are recovered through completed purchases, reflecting your store’s abandoned cart conversion rate.

![Abandoned cart conversion rates widget](images/configuring-abandoned-cart-notification/abandoned-cart-conversion-rates-widget.png)
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.