How to use the newsletter element
Ultimate Popups ships a newsletter sign-up element for the Shopping Experiences (CMS) editor. Drop it into a popup — or any CMS page — to collect subscribers, and optionally reward each confirmed subscriber with a promotion code by email.
This element uses Shopware's own newsletter backend, so subscribers land in the standard Marketing → Newsletter recipients list and obey your newsletter double-opt-in setting. Nothing is stored outside Shopware.
The two ready-made blocks
When you edit a popup's CMS layout, open the block sidebar and choose the Ultimate Popups category. Two blocks are pre-composed so you can place them in one step:
| Block | Layout |
|---|---|
| Newsletter sign-up | A text slot (headline / copy) above the newsletter form. Single column. |
| Newsletter with image | An image on the left and the text + form on the right. Below the md breakpoint the image stacks on top. |
Both blocks contain the same Newsletter form element — the blocks just arrange it. If you want a different layout, you can also drag the bare Newsletter form element into any block or CMS page; it is a self-contained atom and carries its own spacing.
Need a fully custom layout?
These two blocks cover the most common cases. If you want newsletter layouts beyond them — different column splits, background images, custom ordering, or the form combined with other content — you can build your own CMS blocks with our block-builder plugin and drop the Newsletter form element into them. Because the element is self-contained, it works inside any block you compose.
See it on the Shopware Store.
Configure the form
Select the newsletter element to open its config panel.
| Setting | What it does |
|---|---|
| Ask for name | Off by default (email only). Turn on to also collect salutation, first name, and last name. |
| Button label | Text on the submit button. Defaults to a translated "Subscribe". |
| Button colour | Background colour of the submit button. Leave empty to use the theme's primary button colour. |
| Button text colour | Text colour of the submit button. Leave empty to inherit the theme. |
| Text colour | Colour of the form labels and text. Leave empty to inherit the theme; set a light colour when the form sits on a dark background. |
| Success message | Rich-text message shown in place of the form after a successful submit. Defaults to a "check your inbox to confirm" note. |
| Reward with a voucher | Off by default. Turn on to email a promotion code after the subscription is confirmed — see below. |
| Promotion | Shown when the voucher toggle is on. Pick the promotion whose code subscribers receive. |
The form always includes the storefront privacy notice / data-protection consent and the configured captcha, exactly like Shopware's native newsletter form.
Styling stays flexible. The element only carries intrinsic form rhythm; layout comes from the block around it, and popup-specific polish is scoped to popups. Button colours are applied through Bootstrap's own button variables, so hover and active states stay consistent. You can further tune spacing with the CSS variables
--ssd-newsletter-padding,--ssd-newsletter-gap, and--ssd-newsletter-max-widthin the popup's Custom CSS field.
Reward subscribers with a voucher
Turn on Reward with a voucher and select a Promotion. After a subscriber confirms their subscription, the plugin generates their code and emails it automatically.
1. Create a redeemable promotion first
The voucher is your existing Shopware promotion — the popup only hands each subscriber a code into it. Before selecting it, make sure the promotion is genuinely usable, in Marketing → Promotions:
- Active is on.
- It has at least one discount.
- It is assigned to the sales channel(s) the popup runs on.
- It is within its valid-from / valid-until dates (or has none).
- A code model is chosen:
- Individual codes (from a pattern) — every subscriber gets a unique code.
- Fixed code — every subscriber receives the same shared code.
Safeguard. If the selected promotion is not redeemable (inactive, no discount, or not enabled for the popup's sales channel), the plugin does not email a dead code. It skips delivery and writes a warning to the log so you can finish configuring the promotion. This prevents subscribers receiving a code that fails at checkout.
2. The email is already wired up
On install, the plugin ships — and activates — everything needed to deliver the code, so there is no Flow to build:
- A mail template "Newsletter voucher code" (Settings → Email templates), which renders the code via the
variable. Edit its wording freely. - An active Flow "Ultimate Popups: Send newsletter voucher code", bound to the plugin's Voucher assigned event. It stays dormant until a voucher is actually assigned, so it never sends surprise mail.
If you want to extend it (add a second action, change the recipient, etc.), the trigger appears in Flow Builder under Ultimate Popups → Newsletter → Voucher assigned.
Double opt-in: both modes are handled
The flow adapts to your newsletter double-opt-in setting (Settings → Newsletter, per sales channel) automatically — you don't configure anything:
- Double opt-in ON — the subscriber receives Shopware's confirmation email, and the voucher is minted and emailed after they click the confirm link. The page shown after confirming is Shopware's standard confirmation page.
- Double opt-in OFF — the subscription activates on submit, and the voucher email is sent immediately, with no confirmation step.
Either way the code is only ever created once per subscriber.
The popup hides itself after signup
Once a visitor successfully subscribes through a popup, that popup will not show to them again on the same browser — even if its Display Frequency is Always. This is a per-popup flag stored in localStorage (ssd_popup_signup_<popup-id>), so it never affects other popups, and a popup with no newsletter form never sets it.
For cross-device suppression of logged-in customers, add Shopware's "Is newsletter recipient" rule to the popup's Trigger Rules (optionally OR-combined with "Customer logged in = No" so anonymous visitors still see it). See Set frequency and cookie rules.
No additional cookie consent is required — the signup flag is a strictly-functional display preference, like the other frequency flags, already covered under the Required cookie group.
Quick recipe
- Marketing → Promotions — create a promotion that is active, has a discount, and is enabled for your sales channel; choose individual or fixed codes.
- Content → Ultimate Popups — create a popup and open its CMS layout.
- Add the Newsletter sign-up or Newsletter with image block (category Ultimate Popups).
- On the element, set the button label/colours and success message; turn on Reward with a voucher and pick your promotion.
- Save. Subscribers now confirm via your newsletter's opt-in setting and receive their code by email.
See also
- Create a popup — every field in the popup editor
- Set frequency and cookie rules — how signup suppression and frequency caps interact
- Configure appearance — modal size and responsive variants for the popup shell
- Custom CSS — fine-tune the popup's styling