> ## 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.

# Newsletter vouchers

> Reward newsletter sign-up with an automatically generated voucher and display the voucher data by email or directly in the shop.

A voucher is an effective incentive for newsletter sign-up. WEBSALE V8s generates it automatically as soon as someone registers for your newsletter for the first time, and sends it by email.

This should be distinguished from the reverse approach: sending vouchers to existing subscribers to encourage them to buy. This is not a separate function but an ordinary newsletter mailing from the E-Marketing-Manager in which you insert a voucher code.

![Anmeldegutschein Newsletter](https://mintcdn.com/websaleag-44ee7ea6/-4O6W3x8MU7HVGrG/images/anmeldegutschein_newsletter.png?fit=max\&auto=format\&n=-4O6W3x8MU7HVGrG\&q=85\&s=5460ca5498eeb75b741d58af369ec009)

## Who receives the sign-up voucher

| Case | Voucher |
| - | - |
| First sign-up of a prospect | yes |
| First sign-up of an existing customer who has already ordered | yes |
| Unsubscribing and re-subscribing by the same person | no |

> [!NOTE]
>
> Unlike with the new customer voucher, the order history plays no role here. The only deciding factor is whether the person has ever registered in the newsletter system before.

> [!WARNING]
>
> The one-time issue is a property of the newsletter system, not a property of the voucher. Expect to be asked why someone does not receive a second voucher, and have an answer ready.

## What kind of voucher is created

The sign-up voucher is a separate type in the voucher generator with fixed properties. The following points cannot be configured.

| Property | Definition |
| - | - |
| Amount type | absolute. A percentage sign-up voucher is not possible |
| Voucher type | promotional voucher. Price-controlled products are therefore excluded |
| Remaining amount | expires after redemption; it cannot be used for a second order |

> [!NOTE]
>
> Because the vouchers are only created at the moment of sign-up, a validity of "X days from creation" is usually more sensible here than a fixed end date. A fixed date means that a prospect who signs up late receives a voucher with only a few days left.

## Prerequisites

For the sign-up voucher, **both** modules must be activated for your shop: the voucher generator and the E-Marketing-Manager. Contact your WEBSALE representative to do so.

> [!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`.

In addition, voucher entry must be integrated in the shop. Without it, the recipient cannot redeem their code later.

Guide: Provide voucher entry · Guide: E-Marketing-Manager · Reference: Voucher-Txt section

## Step 1: Creating the sign-up voucher

In the online service area, create a newsletter sign-up voucher in the voucher generator and specify for which subshops it should be valid.

> [!WARNING]
>
> Only one sign-up voucher can be stored per subshop at the same time. If you want to replace a running campaign, replace the existing voucher instead of creating a second one.

## Step 2: Activating generation and creating the email

In the E-Marketing-Manager, under **Settings**, activate the generation of vouchers for newsletter sign-up.

The E-Marketing-Manager then automatically creates an email for sending the voucher under **Administration mails**, which you can edit freely.

> [!WARNING]
>
> The voucher number must be included in this email. Insert the corresponding tag using the WEBSALE tag button of the newsletter editor. Without the number, the email is sent, but the recipient cannot do anything with it, and the voucher number is lost to them.

## Step 3: Displaying the voucher data in the shop (optional)

In addition to the email, the voucher data can be displayed in the shop immediately after sign-up. The prospect then sees their code without waiting for the email.

Add the following section to the ExternInclude area for target group management `incl_newsletter.htm`, within `{E-NL-SEC-subscribe}`. If the voucher should also appear in the subscriber's management view, additionally add it within `{E-NL-SEC-manage}`.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{E-NL-SEC-subscribe}

   {E-NL-Voucher}
      Gutscheincode: ~E-NL-Voucher_Code~
      Dieser Gutschein hat einen Wert von ~E-NL-Voucher_Amount~ ~E-NL-Voucher_Currency~.
      Er ist gültig von ~E-NL-Voucher_ValidFrom~ bis ~E-NL-Voucher_ValidUntil~.
      Der Mindestbestellwert beträgt ~E-NL-Voucher_MinOrderValue~ ~E-NL-Voucher_Currency~.

      {@E-NL-Voucher_Subshop}

         {E-NL-Voucher_Subshop(desktop)}
            <!-- Der Gutschein gilt im Subshop "desktop", in dem der Interessent gerade unterwegs ist -->
            Lösen Sie den Gutschein am besten gleich ein.
         {/E-NL-Voucher_Subshop(desktop)}

         {!E-NL-Voucher_Subshop(desktop)}
            Der Gutscheincode ist nur im Subshop ~E-NL-Voucher_Subshop~ gültig.
         {/!E-NL-Voucher_Subshop(desktop)}

      {/@E-NL-Voucher_Subshop}
   {/E-NL-Voucher}

{/E-NL-SEC-subscribe}
```

| Tag | Content |
| - | - |
| `E-NL-Voucher` | section that only applies if a voucher was generated |
| `E-NL-Voucher_Code` | the voucher number |
| `E-NL-Voucher_Amount` | the voucher amount |
| `E-NL-Voucher_Currency` | the currency |
| `E-NL-Voucher_MinOrderValue` | the minimum order value |
| `E-NL-Voucher_ValidFrom` | start of validity |
| `E-NL-Voucher_ValidUntil` | end of validity |
| `E-NL-Voucher_Subshop` | loop over the subshops in which the voucher is valid |

> [!NOTE]
>
> The loop over the subshops is worthwhile as soon as the voucher is not valid everywhere. The comparison with a fixed subshop ID as a parameter, `desktop` in the example, distinguishes between "redeemable here" and "only redeemable elsewhere". Without this distinction, some recipients will try to enter the code in the wrong subshop.

> [!WARNING]
>
> The section must be placed in the `{E-NL-SEC-subscribe}` or `{E-NL-SEC-manage}` area. Outside these areas, the voucher data is not available and the tags remain empty.

Reference: E-NL-Voucher · E-NL-Voucher\_Code · E-NL-Voucher\_Amount · E-NL-Voucher\_Currency · E-NL-Voucher\_MinOrderValue · E-NL-Voucher\_ValidFrom · E-NL-Voucher\_ValidUntil · E-NL-Voucher\_Subshop · WS-Include

## Sending vouchers to existing subscribers

No separate setup is required for this. Create the vouchers as usual in the voucher generator and insert the code into your newsletter mailing in the E-Marketing-Manager.

> [!NOTE]
>
> A universal voucher with a limited number of redemptions is suitable for such a mailing, because all recipients then receive the same code and you can still cap the scope of the campaign.

## Related topics

* Guide: Offering vouchers: Overview
* Guide: Create or import vouchers
* Guide: New customer vouchers
* Guide: E-Marketing-Manager


## Related topics

- [Provide voucher entry](https://dokumentation.websale.de/en/v8s/gutscheine-anbieten/gutschein-eingabe-vorsehen.md)
- [E-NL- (Voucher for newsletter subscription)](https://dokumentation.websale.de/en/v8s/referenz/tags/e-nl/gutscheine.md)
- [VOUCHER- (Voucher)](https://dokumentation.websale.de/en/v8s/referenz/tags/voucher-gutschein.md)
- [Vouchers](https://dokumentation.websale.de/en/admin-interface/marketing/gutscheine.md)
- [newsletter - Newsletter](https://dokumentation.websale.de/en/konfiguration/newsletter-newsletter.md)


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