Skip to content

Configuring Email & Newsletter Templates

All settings live under Stores → Configuration → Hyvä Commerce → Email Templates. The email and newsletter features each have their own group, plus a group of preview data used by the editor. Everything depends on Hyvä CMS itself being enabled (Hyvä CMS → General → Enable Hyva CMS).

Email Templates Settings

Found under Hyvä Commerce → Email Templates → Email Templates:

Setting What it does
Enable for Email Templates Master switch for the Hyvä editor on transactional email templates.
Email Templates Enabled by default New email templates get the Hyvä editor enabled automatically.
Include Header Wraps every Hyvä email with a shared header.
Header Template Which Liveview-enabled template to use as that header (0 = the built-in default).
Include Footer Wraps every Hyvä email with a shared footer.
Footer Template Which Liveview-enabled template to use as that footer (0 = the built-in default).
Show Product Images in Order Items Adds a product thumbnail column to the Order Items component in order-related emails.
Default Preheader Text Fallback inbox-preview snippet for emails without their own preheader. Supports variables like {{var store.frontend_name}}. Keep it under about 90 characters.

Reusable headers and footers

Build your header and footer once as their own email templates, then select them here. Every transactional email picks them up automatically, and you edit them in a single place.

Setup Buttons

Two one-click setup actions sit at the bottom of the Email Templates group:

Create Email Templates creates a Hyvä email template for every default Magento email type (order, invoice, shipment, credit memo, customer account, password reset, newsletter subscription confirmations, and more), pre-filled with ready-made content. Templates that already exist are skipped, so the button is safe to press again after adding new presets.

Map Templates to Configuration points Magento's email settings (Sales emails, Customer emails, Newsletter confirmations) at the templates created above, in one go. Without mapping, the templates exist but Magento keeps sending the old ones.

Flush the config cache after mapping

The mapping writes to core config. Run bin/magento cache:clean config (or flush from the Cache Management page) so the new template assignments take effect.

A template failed to create?

The success message tells you how many templates were created, skipped, or failed. Failures are logged to var/log/liveview.log.

Email Preview Data

Found under Hyvä Commerce → Email Templates → Email Preview Data. These values fill in Magento template variables in the editor preview, so the preview looks like a real email instead of raw {{var ...}} placeholders:

  • Preview First Name / Last Name / Email / Street / City / Country - the dummy customer.
  • Preview Order (Increment ID) - enter a real order increment ID (for example 000000042) and the preview uses that order's actual items, totals, addresses, and product images.
  • Preview Product SKUs - comma-separated SKUs shown as ordered items when no order ID is set.

Use a real order

A real order makes the preview (and the email client simulator) far more realistic - real product names, real totals, real images. Any order from your store works.

Newsletter Templates Settings

Found under Hyvä Commerce → Email Templates → Newsletter Templates:

Setting What it does
Enable for Newsletter Templates Master switch for the Hyvä editor on newsletter templates.
Newsletter Templates Enabled by default New newsletter templates get the Hyvä editor enabled automatically.
Default Preheader Text Fallback inbox-preview snippet, same behavior as the email one.
Include Default Header Prepends a store-logo header to every Hyvä newsletter.
Include Default Footer Appends a footer with your store details and the legally required unsubscribe link to every Hyvä newsletter.

Keep the unsubscribe link

The default footer includes the {{var subscriber_data.unsubscription_link}} unsubscribe link that most jurisdictions require in marketing email. If you disable the default footer, make sure your newsletter content includes an unsubscribe link some other way - for example with an HTML component in the template itself.

The default newsletter header and footer are theme-overridable templates. Developers can override Hyva_EmailTemplates::newsletter/header/default.phtml and Hyva_EmailTemplates::newsletter/footer/default.phtml in a theme - see the developer documentation.

Newsletter Preview Data

Found under Hyvä Commerce → Email Templates → Newsletter Preview Data. The dummy subscriber (first name, last name, email) used to resolve {{var subscriber.firstname}} and friends in newsletter previews and test sends.