# 1. Description

**Dynamic Delivery Countdown** adds a live countdown timer to your product detail pages — just like Amazon: "Order within 3h 22m for delivery by Wednesday, March 19."

This concrete delivery promise motivates customers to order immediately, increasing conversion rates.

![Countdown on the product detail page in fixed mode](https://459847022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-1972196547%2Fuploads%2Fgit-blob-993b919dd94ec4e43dd1138541e79c36e4a28495%2F1.png?alt=media)

## What the plugin does

The plugin calculates the expected delivery date server-side for each product and passes it as JSON data to the product detail page. A JavaScript plugin updates the countdown every second in the browser — no page reload required. When the daily order deadline passes, the JavaScript automatically recalculates the delivery date for the next business day.

## Four delivery date modes

Choose the mode that best fits your product catalog:

| Mode                                      | Description                                                                   |
| ----------------------------------------- | ----------------------------------------------------------------------------- |
| **Fixed shipping days**                   | Always uses the configured shipping days, regardless of product delivery time |
| **Product delivery time — earliest date** | Uses the minimum value from the product's Shopware delivery time              |
| **Product delivery time — latest date**   | Uses the maximum value from the product's Shopware delivery time              |
| **Product delivery time — date range**    | Shows a range: "Delivery between \[earliest] and \[latest date]"              |

![Storefront countdown in range mode](https://459847022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-1972196547%2Fuploads%2Fgit-blob-041d89f9eeab834cec104a4a6f21af9494796060%2F4.png?alt=media)

## Weekends and holidays

The plugin accounts for non-delivery days: weekends can be excluded globally, and individual public holidays can be entered as a date list in `YYYY-MM-DD` format. If a calculated delivery date falls on an excluded day, the next available business day is shown automatically.

## Threshold for long delivery times

For products with long lead times, you can configure a threshold in days. When exceeded, you can either hide the countdown entirely or show the countdown without a concrete date — "For fastest possible delivery."

![Plugin configuration: excluded days and long delivery time threshold](https://459847022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-1972196547%2Fuploads%2Fgit-blob-75e927a6ef4b35a6b0922142a464120bcb82b8e6%2F6.png?alt=media)

## Technical details

* Compatible with Shopware 6.6
* Requires PHP 8.2 or higher
* All calculations run in the customer's browser — no external services, no additional server requests
* Configurable per sales channel
* Available in German and English