Skip to content

Writing a newsletter

Newsletter → Newsletter → Create

The „Edit newsletter" form with editor and sidebar

The form has two columns: the content on the left, everything to do with sending on the right. You can save at any time; as long as you do not click Schedule sending, nothing goes out.


Left: the content

Name of the newsletter

The field at the very top, where a post would have its title. It is an internal name — it appears in the list and in the delivery log, not automatically in the mail.

It can still end up in the mail: the subject is %nl_name% out of the box, and the Kopfbalken template writes it into the coloured bar. So name the newsletter the way the subject line should read — „September issue: apple juice from the region", not „NL 09/2026".

Content (HTML)

The WordPress editor, the same one as for a post: Visual for writing, Code for the HTML.

Only the content goes here, not the whole mail. Header, footer, logo, unsubscribe link and legal details come from the template and therefore appear in no editor.

Three things that are different in a mail than on a website:

  • No flexbox, no grid, no external stylesheets. Outlook renders with the Word engine and ignores all three. If you need columns, use a table — or the Zweispaltig template.
  • Images need width and height as attributes. A max-width in the style alone makes Outlook draw the image at full pixel width.
  • Write every link out in full, with https:// and domain. A path like /offer leads nowhere in a mailbox.

There are two buttons below the editor:

Save and show preview Opens the finished mail in a new window — content in the template, placeholders resolved. Only possible after the first save
Copy content into the text version (striptags) Takes the HTML, strips the markup and writes the result into the text field below. Existing text is overwritten — you are asked first

Content (text)

The version for mail programs that show no HTML, and for everything that reads a mail mechanically. It is sent as text/plain, unchanged: a line break is a line break, HTML would be visible gibberish here.

Do not leave it empty. A mail without a text version is a signal to spam filters, and it costs nothing to press Copy content into the text version and read through the result.

Clicks are not counted in the text version

Click tracking rewrites only the links of the HTML version. In the text version your addresses appear exactly as you wrote them — a tracking address is long and meaningless, and anyone having to type it out would get nowhere.


Right: settings

Layout (HTML)

The template your content sits in. What is preset here comes from Defaults; for this one issue you can deviate.

Target groups

Who receives the newsletter. Multiple selection with Ctrl (Mac: Cmd). The number in brackets is the count of confirmed subscribers per group.

Below the list is the number of recipients. It is not the sum of the brackets: anyone in two selected groups counts once and receives the mail once.

Without a group, nothing happens

A newsletter without a target group can be saved but not scheduled. Only subscribers with the status Active count — anyone waiting for confirmation or inactive receives nothing.

Send as

HTML and text mail Default, and right in almost every case. The mail program takes what it can handle
HTML mail HTML only. For those who do not want to maintain the text version — at the price of being unreadable for some recipients
Text mail Text only. No template, no logo, no open tracking

Priority

Ends up as a header in the mail. Most mail programs show it as an exclamation mark, some not at all. It changes nothing about the sending — in particular it is not an order in the queue.

Leave it on Normal. „Very high" on a newsletter is a bad sign to spam filters.

Show in archive

Whether the newsletter is listed on the archive page after sending. The checkbox controls the list only: the „View this newsletter in your browser" link from the mail works in every case — whoever received the newsletter may also read it again.

This is the only checkbox that can still be changed after sending.


Right: sending settings

Four fields that override the global defaults from Sender and subject for this one issue. Leaving one empty means: the default applies.

Field
Subject %nl_name% out of the box. Placeholders are allowed
Sender Name <address@your-domain.test>. The address must belong to your domain
CC Goes out with every mail. Visible to the recipient — with a newsletter, almost never what was meant
BCC A silent copy per mail. With 400 recipients, that is 400 copies

What the plugin checks before anything goes out

When you open a newsletter that has not been sent, on a test send and when scheduling, the plugin checks two things and reports them at the top of the form:

Placeholders nobody resolves. Subject, text and HTML version are run through the replacement once; whatever is still standing there as %name% afterwards will reach the recipient exactly like that.

This newsletter contains placeholders that nobody resolves: %abo_vname%.

That is either a typo — it is called %abo_vorname% — or the module that brings the placeholder along is not running.

Files belonging to a module that is not running. If attachments hang on this newsletter but the Attachments module is switched off, they will not go out. That too appears as a message there.

Both messages disappear by themselves once the cause is fixed. They prevent nothing — you can send every newsletter unchanged.

The next issue

The quickest way to the next issue is Copy in the list: content and target groups are carried over, and the new newsletter is a draft.