Skip to content

Building Newsletter Templates with the Hyvä Editor

Newsletter templates use the same editor and the same email components as transactional emails. This guide covers what is different: enabling the editor for newsletters, the default header and footer, subscriber variables, and how the newsletter queue picks up your content.

Enabling the Hyvä Editor on a Newsletter Template

  1. Make sure Enable for Newsletter Templates is on - see Configuration.
  2. Go to Marketing → Communications → Newsletter Template and open (or create) a template.
  3. Tick the Enable Hyvä Editor checkbox and save.
  4. Open the template in the Hyvä editor and build your campaign.

Every Hyvä newsletter can be wrapped automatically:

  • Include Default Header prepends your store logo.
  • Include Default Footer (on by default) appends your store details and the unsubscribe link.

This means you can focus your template purely on campaign content - the legal necessities are handled for you.

Unsubscribe link may not be optional

Marketing email may require an unsubscribe option in most jurisdictions. In those cases, keep the default footer enabled, or make sure your template includes {{var subscriber_data.unsubscription_link}} somewhere else (for example in an HTML component). We recommend checking applicable laws and compliance policy.

Subscriber Variables

Newsletter-specific variables are available from the Insert Variable picker in rich text fields:

Variable Resolves to
{{var subscriber_data.unsubscription_link}} The personal unsubscribe URL
{{var subscriber_data.confirmation_link}} The subscription confirmation URL
{{var subscriber.firstname}} / {{var subscriber.lastname}} The subscriber's name
{{var subscriber.email}} The subscriber's email address

The Dynamic Button component also offers Newsletter Unsubscribe and Subscription Confirmation as link types, so you can turn either into a proper button.

In the editor preview these variables resolve using the dummy subscriber from Newsletter Preview Data.

How the Newsletter Queue Picks Up Your Content

Magento newsletters are sent through a queue (Marketing → Communications → Newsletter Queue). When you queue a template, Magento snapshots the template content into the queue at that moment:

  1. Build and save your template in the Hyvä editor.
  2. Queue the newsletter for sending. The rendered Hyvä content (with subscriber variables still unresolved) is copied into the queue.
  3. Each subscriber's send resolves their personal variables - name, unsubscribe link - at delivery time.

Edits after queueing don't reach the queue

Because the queue stores a snapshot, changes you make to the template after queueing do not update newsletters already in the queue. Delete the queue entry and queue the template again to send the updated version.