You can create consistent, branded email experiences across all your workflows with a reusable Email layout. Build your headers, footers, and branding elements once, then apply them to any email step across multiple workflows, bringing consistency, maintainability, and efficiency to your email communications.
Learn more about Email Layouts in our documentation.
Design your layouts using the block-based visual editor. Add elements like headers, footers, images, and buttons by pressing the / key, making it easier for non-technical teammates to collaborate on email design. When you need complete control, switch to the code editor to work directly with raw HTML.
Every layout must include the {{content}} variable, which dynamically injects the content from your email step into the layout. Write your email content once in the workflow, and it automatically inherits your branded layout styling—eliminating the need to duplicate branding elements across every email.
Each environment maintains its own set of layouts, with every environment including one default layout. Create additional layouts based on your needs, such as transactional, marketing, or newsletter types, giving you flexibility across different environments.
Note: You can share layouts by publishing changes to other environments.
Use subscriber variables like {{subscriber.firstName}} and {{subscriber.email}} throughout your layouts to personalize branding elements. Only subscriber variables are supported in layouts to ensure compatibility across all workflows.
Use the Layout selector in the workflow email step editor to apply any layout to email steps. The selected layout wraps around the content written in the email editor, and you can preview the complete rendered email using the Test Workflow feature with actual subscriber data and different locales.
Control layout selection programmatically when triggering workflows:
- layoutId: undefined - Use the default layout for the environment (set by default on step creation)
- layoutId: null - No layout applied (content only)
- layoutId: "layout-id" - Use the specified layout by ID
Email Layouts are now available on the Novu dashboard sidebar. Free plans include one layout per environment, while Pro and higher plans support up to 100 layouts per environment. Navigate to the Layouts section in your dashboard to start building consistent email experiences.
