Email builder for listmonk
Tabular is an email builder for listmonk. Design responsive emails on a visual canvas, upload them to listmonk as a campaign or transactional template in one click, and update the same template whenever they change.
{{ .Subscriber.FirstName }}How Tabular works with listmonk
listmonk is a free, open-source, self-hosted newsletter and mailing list manager. With Tabular, your team designs the emails and listmonk sends them.
- Design in Tabular
On a visual canvas, with your design system and your team.
- Upload to listmonk
Each email becomes a listmonk campaign or transactional template, ready for campaigns and transactional emails.
- Change it, update it
Edit the email in Tabular and overwrite the same template. No copy and paste.
Emails you can build for listmonk
Connect listmonk
listmonk connects with your instance URL, your API username and your API token from listmonk. You add them once, right in the export dialog.
- Create an API user in listmonk
In listmonk 4 or later, open AdminUsers and add a user of type API, with a role that can manage templates. The token is shown once.
- Open an email and click Export
Choose Send via integration, then pick listmonk under All integrations.
- Fill in the form and upload
Name the connection, add the instance URL, the API username and the API token, and click Upload.
- It’s saved for your workspace
Next time, pick it under Your authentications. Anyone in the workspace who can edit emails can use it.
Credentials are stored encrypted and belong to the workspace, not to one person. Remove them any time in workspace settings, under Integrations; what’s already in listmonk stays there.
Create a new listmonk template
Any email in Tabular can become a listmonk campaign or transactional template. Export it once, and Tabular remembers the template it created, so you can update it later.
- Open the email and click Export
Choose Send via integration. The language switcher in the header sets which language goes out.
- Pick your listmonk connection
Then choose where it goes, under Upload to: Campaign templates or Transactional templates.
- Upload
Tabular creates a listmonk campaign or transactional template named after the email, with its subject line (for transactional templates). You’ll see Uploaded to listmonk.
- Find it in listmonk
Open CampaignsTemplates. Pick a campaign template in a campaign’s Template field. Send a transactional one through
/api/txwith its ID.
Spring collection
Spring, in full bloom.
Shop the collectionLumen
Welcome to Lumen.
OpenLumen
June picks.
OpenSpring collection
Spring, in full bloom.
Shop the collectionLumen
Welcome to Lumen.
OpenLumen
June picks.
OpenSpring collection
Spring, in full bloom.
Shop the collectionSpring collection
Spring, in full bloom.
Shop the collectionA campaign template needs {{ template "content" . }} exactly once: it’s where each campaign’s own content goes. Add it with a custom code block.
Update the listmonk template after changes
Changed the email? Export again and pick the template it’s linked to. Tabular overwrites it in place: same template, same ID, new design.
- Change the email in Tabular
Text, images, layout, or a change to your design system.
- Click Export, then Send via integration
Under Update a connection, each card is one template in listmonk, with its language and ID.
- Click the card
Tabular overwrites that template with the new HTML and subject line. Nothing new is created.
- Want a copy instead?
Choose Create new connection. That always makes a new template.
Spring collection
Spring, in full bloom.
Shop the collectionSpring collection
Spring, in full bloom.
Shop the collectionLumen
Welcome to Lumen.
OpenLumen
June picks.
OpenSpring collection
Spring, in full bloom.
Shop the collectionSpring collection
Spring, in full bloom.
Shop the collectionLumen
Welcome to Lumen.
OpenLumen
June picks.
OpenSpring collection
Spring, in full bloom.
Shop the collectionSpring collection
Spring, in full bloom.
Shop the collectionlistmonk links templates. Campaigns that haven’t gone out render with the updated template, and the next transactional email uses it right away.
Personalization variables in listmonk
Tabular never rewrites a merge tag. Type listmonk’s own syntax, and it reaches listmonk exactly as you wrote it.
| To show | Write in Tabular |
|---|---|
| First name | {{ .Subscriber.FirstName }} |
| First name, or “there” | {{ .Subscriber.FirstName | default "there" }} |
| A custom attribute | {{ .Subscriber.Attribs.city }} |
| Transactional data | {{ .Tx.Data.order_id }} |
| Unsubscribe link | {{ UnsubscribeURL }}As a link’s URL |
- Type the tag in any text
Write
{{ .Subscriber.FirstName }}where it should go: a heading, a paragraph or a button. - Make it a variable
Select it and click { } in the text toolbar. It becomes a chip that can’t break while you edit.
- Give it example text
Type “Max”, and the canvas and previews show a name instead of code. The export keeps the tag.
- Links work the same way
Paste a tag as a link’s URL, like listmonk’s unsubscribe link, and it goes out as written.
Hi Max, your spring picks are here.
Dynamic content: if/else and loops in listmonk
listmonk supports conditions and loops. In Tabular you wrap any block in them: show it to some people only, or repeat it for every item in a list.
- Select the block
A section, a row, a text, an image or a button.
- Add Show/hide block
In Dynamic content on the right, paste the condition’s opening and closing tags.
- Add Repeat block for lists
The same, with the loop’s tags. Inside the block, use each item’s fields, like
{{ .name }}. - Export
Tabular wraps the block in your tags, and listmonk fills them in when it sends.
{{ if eq .Subscriber.Attribs.city "Bengaluru" }} <table class="offer">…</table> {{ end }} {{ range .Tx.Data.items }} <tr><td>{{ .name }}</td></tr> {{ end }}
There’s no else field. For the other case, give a second block the opposite condition, like {{ if ne .Subscriber.Attribs.city "Bengaluru" }}, or type a whole if/else inside one text.