> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# "Free shipping" voucher

> Issue a voucher that waives the shipping costs of an order entirely, and understand how it interacts with the minimum order value and shipping methods.

Instead of deducting an amount, a voucher can waive the shipping costs. This is an effective promotional tool, because the benefit is clearly stated for the customer and your discount remains capped.

Nothing needs to be set up in the shop for this. The property is attached to the voucher.

## How the waiver takes effect

The shop sets the shipping costs to zero as soon as a redeemed voucher carries this property.

| Aspect | Behavior |
| - | - |
| Amount waived | in full, regardless of how high the shipping costs were |
| When it is applied | at the very end of the shipping cost calculation |
| Multiple vouchers | a single voucher with this property is enough |
| Multiple shipping methods in the basket | the waiver applies to all of them |

> [!NOTE]
>
> Because the waiver is applied last, it overrides everything calculated before: base costs, per-item, weight-based and item-dependent costs, a stored **minimum shipping flat rate** and any reductions already deducted. A shipment that would otherwise never fall below a base amount still costs nothing with this voucher.

> [!WARNING]
>
> If the voucher has its own minimum order value and it is not reached, the voucher is suppressed and the shipping costs remain. This is intended, but it leads to questions if the promotion does not clearly state the minimum order value.

> [!NOTE]
>
> Free shipping can come from three sources in the shop: from the shipping method itself, from the customer account and from such a voucher. If one of the first two already applies, the voucher has no effect, without anyone noticing. With a promotion for customers who have permanent free shipping, you therefore give nothing away, but you also gain nothing.

## Prerequisite

The voucher generator must be activated. Contact your WEBSALE representative to arrange this.

> [!NOTE]
>
> If the vouchers come from an external system and are therefore not in WEBSALE format, add the entry `ExternalVouchers-Allow = yes` in the `<Voucher-Txt>` section of the `shop.config`.

Guide: Providing voucher entry · Reference: Voucher-Txt section

## Step 1: Create the voucher

When creating the voucher in the voucher generator, enter the following string in the **Kundenspezifische Features** (custom features) field at the very bottom.

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<g><t>FreeShipping</t></g>
```

| Bracket | Meaning |
| - | - |
| `<g>…</g>` | encloses the entire function |
| `<t>…</t>` | the type, here `FreeShipping` |

> [!NOTE]
>
> This function has no further settings. It is either set or not.

> [!NOTE]
>
> The property can be combined with a value. A voucher can therefore deduct ten euros and waive shipping at the same time. You can also create it without a value, in which case free shipping is the entire benefit.

## Step 2: State the benefit in the shop (optional)

Otherwise, the customer only sees that the shipping cost line is missing or shows zero. An explicit notice makes the benefit visible.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{VOUCHER-SpecialFeatures_FreeShipping}
   Mit diesem Gutschein ist Ihre Bestellung versandkostenfrei.
{/VOUCHER-SpecialFeatures_FreeShipping}
```

> [!NOTE]
>
> The section refers to the currently loaded voucher data, i.e. to an entered voucher or to one you have loaded with `VOUCHER-LoadData`.

> [!NOTE]
>
> There is no rejection reason for this type of voucher. A free shipping voucher is never rejected on that account. If there are no shipping costs, simply nothing happens.

Reference: VOUCHER-SpecialFeatures\_FreeShipping · VOUCHER-LoadData

## Related topics

* Guide: Offering vouchers: Overview
* Guide: Creating or importing vouchers
* Guide: Providing voucher entry


## Related topics

- [VOUCHER- (Voucher)](https://dokumentation.websale.de/en/v8s/referenz/tags/voucher-gutschein.md)
- [Practical examples - Vouchers](https://dokumentation.websale.de/en/frontend/praxisbeispiele/gutscheine.md)
- [$wsCheckout - Checkout](https://dokumentation.websale.de/en/frontend/referenz/module/wscheckout.md)
- [Payment, shipping and order completion](https://dokumentation.websale.de/en/v8s/referenz/tags/ws/zahlung-versand-und-bestellabschluss.md)
- [Vouchers](https://dokumentation.websale.de/en/admin-interface/marketing/gutscheine.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.