Since Mautic 3.3, Mautic has shipped with an updated, modern builder for creating emails and landing pages. It is available as a beta release - an optional plugin - until Mautic 4.0 where we plan to fully replace the legacy builder, assuming all goes well during the beta phase.
To use your existing templates with the new Email builder, you will need to add one line to your configuration file. Read on for further details.
GrapesJS is an open-source, multi-purpose, Web Builder Framework which combines different tools and features with the goal to help build HTML templates without any knowledge of coding.
GrapesJS comes with a set of built-in blocks, in this way you're able to build your templates faster. If the default set is not enough you can always add your own custom blocks.
GrapesJS implements a simple and powerful Style Manager module which enables independent styling of any component inside the canvas. It's also possible to configure it to use any of the CSS properties.
GrapesJS gives you all the necessary tools you need to optimize your templates to look awesomely on any device. In this way you're able to provide various viewing experiences. In case more device options are required, you can easily add them to the editor.
You can nest components as much as you can but when the structure begins to grow the Layer Manager comes very handy. It allows you to manage and rearrange your elements extremely fast, focusing always on the architecture of your structure.
You don't have to care about the code, but it's always there, available for you. When the work is done you can grab and use it wherever you want. Developers could also implement their own storage interfaces to use inside the editor.
With the Asset Manager is easier to organize your media files and it's enough to double click on the image to change it.
Since Mautic 3.3-RC1 the builder is available to enable in the Plugins section of Mautic. Go to the Settings (click the cog wheel at the top right) > Plugins > GrapesJS and click on it. Change the slider to Yes.
Now you will need to clear your Mautic cache (located in var/cache) before you will be able to work with the new GrapesJS builder.
To use your existing templates with the new Email builder, you will need to add one line to your configuration file in the template folder:
If you wish to use the theme in multiple builders, you can use this syntax:
"builder": ["legacy", "grapesjsbuilder"],
NOTE: This syntax changed between Mautic 3.3.* and Mautic 4 to enable support for multiple builders - if you have been testing in the beta phase you will need to update your configuration files, otherwise you will experience a 500 error.
From the 3.3 General Availability release there will be three email templates that support MJML, and also some landing page templates will also be made available in the near future.
If you search through the list of available themes, the new MJML themes
Confirm Me will not be available until you enable the GrapesJS plugin.
Please use the issue queue on the Github repository to check for the latest updates and report bugs with the plugin. Be sure to search first in case someone has already reported the bug!
In case you are not happy with the plugin at the moment, you can easily switch back to the legacy Builder (original Mautic Builder). You can do so very quickly:
The GrapesJs Plugin has been unloaded, and the legacy builder will now be active again.
Thank you to everyone who contributed to this project. Special thanks to Webmecanik for all their hard work in creating and contributing this amazing new builder; to Joey from Friendly Automate for donating three email themes to the Community, and to Adrian Schimpf from idea2 and Alex Hammerschmied from hartmut.io for their work in leading the project.
And of course a really big thank you to all the contributors who have helped to bring this project to this point, many of whom are listed in our release notes.
Found errors? Think you can improve this documentation? edit this page