Using a Postmark Starter Template

Postmark includes pre-built templates for common types of transactional emails like welcome emails, comment notifications, password resets, receipts and invoices, trial expirations, user invitations, and comment notifications. With our editor and tools, you have complete control over customizing each template to fit your exact needs.

Templates are available when sending via the Postmark API.

Choose a template to get started

Navigate to one of your Postmark Servers, and select Templates.

On the Templates select Add template.

For this example we're going to walk you though on using our Welcome template.

After choosing the Welcome Template, there’s an option to use the Template with an existing Layout (if one exists), add a a new Layout from the Template, or proceed without a Layout.
Layouts let your Templates share common elements like CSS, headers, or footers. Want to learn more about Layouts? Check out our support doc that covers the ins and outs of Layouts.

With a Layout optionally selected, you can then choose the starter Template.

Preview your template

Since Postmark's Templates can involve sending dynamic data, we've made it easier for you to preview your template with Postmark's test variable editor. Start by editing the JSON variables and the preview will update automatically.

Please note that any changes you make to the test variables will reset each time you exit the editor page. Test variables are not saved with a template since they're solely for test purposes.

Edit your template

If you need to make any changes to your template click on the "Edit" tab on the editor. Here you'll be able to edit the HTML and Text versions of your email.

Sent a Test Email Modal

You might notice that Postmark's Starter Templates include the CSS in a style block in the head of the email, instead of inline with the content like most email clients prefer. This is because Postmark will automatically inline those styles when the email is delivered. This makes it easier for you to edit while still bringing all the benefits and reliability of inlining.

We're also using our very own templating syntax called Mustachio. This originally has its roots with Mustache, but includes a few advanced features that make the language even more powerful. Check out the Mustachio Wiki for a quick how-to on syntax usage.

Send a test email

Once everything looks good you'll want to see how your template renders in an actual email client. Click 'Send a test email' to send a test email using your current test variables, to an email address of your choice.

You can even send test emails to other services like Litmus, or Email on Acid, which let you preview your template in every major email client. We've done the work to ensure that our starter templates look beautiful out-of-the-box, but if you modify these templates you should send a test email to make sure everything still looks great.

Integration into your app

Click on "API Snippets" and you can grab some code to get started.

Test Send Dialog

If you're using our official Postmark's Official Libraries, just update to the latest version to take advantage of our Templates API.

Last updated June 25th, 2019

Still need some help?

Our customer success team has your back!