Joyful Docs

Templates

Wrap your newsletters in consistent branding.

What templates do

A template is a layout with a placeholder for your content. You design it once—header, footer, colors, whatever you want consistent—and then every newsletter you send using that template gets wrapped in it.

Creating a template

Go to Home in the sidebar and click New Template. Design your layout using the same editor as newsletters. The key part: type / and insert a Placeholder block where newsletter content should appear.

When you create a newsletter using this template, your writing replaces that placeholder.

Using a template

When editing a newsletter, select a template from the dropdown. Preview to see how your content looks inside the template. The template only shows in preview and the sent email—your editor stays clean.

Editing templates

Changes to a template affect all future newsletters using it. Already-sent newsletters stay as they were.

Team templates

When working in a team context, templates are shared with everyone. Editors and above can create and modify team templates.

Custom CSS

Pro / Team

Templates can include custom CSS that applies to all newsletters using them. Click the CSS button in the template editor to add styles.

This is great for consistent branding—set your fonts, colors, and spacing once in the template, and every newsletter inherits them.

If a newsletter has its own custom CSS, it overrides the template's CSS. See the newsletter CSS docs for syntax details.

Tip: Use .newsletter-body to target only the newsletter content, not your template header or footer. For example, .newsletter-body > p:first-child styles just the opening paragraph of the newsletter.

Keep it simple

Fancy HTML layouts break in email clients. Stick to basic elements: logo image, text, horizontal lines. Test by sending yourself a preview before using a new template.