MJML
mjml.io
- Free plan
- Open source
- Windows
- macOS
- Linux
- Web
- Browser extension
- API
- Self-hosted
What MJML is
MJML is a markup language for building responsive email layouts. Its engine turns MJML into email HTML with nested tables and inline CSS, with responsive design for popular email clients including Outlook. Reusable, extensible components provide a starting point, and users can create custom components. MJML is open source under the MIT license, and it has a free online editor for writing and rendering markup. A free REST API also renders MJML into responsive HTML. The command-line interface compiles files, watches for changes, and writes generated HTML to a chosen file. Local installation uses npm on macOS, Linux, or Windows; plugins are available for Visual Studio Code and Sublime Text, alongside a desktop app. API accounts receive an Application ID and two keys, with public and secret keys intended for browser and back-end use respectively. MJML ignores includes by default and confines enabled include paths to approved roots. Rendering produces HTML, but sending it requires an email service provider or a shell. The mj-button component is not fully clickable because of email-client support.
Who it suits
MJML suits developers who prefer code-first email creation and want reusable components or custom markup. It can also suit teams that need a command-line workflow or a REST API for rendering.
Good to know, and what to watch
- Generates responsive HTML with nested tables and inline CSS.
- Includes reusable and extensible components.
- Free online editor and REST API.
- CLI can compile files and watch for changes.
- Plugins are available for Visual Studio Code and Sublime Text.
- Rendered HTML must be sent through another service or a shell.
- The mj-button component is not fully clickable.
- Local installation requires npm.
Plans
Every plan and priceFree
MJML API
MJML framework and online editor
Free plan
Getting started
- Open the MJML website or free online editor
- Write MJML markup with reusable components
- Install MJML with npm on macOS, Linux, or Windows if working locally
- Use the CLI, editor plugin, desktop app, or REST API to render HTML
- Choose an email service provider or shell to send the generated HTML
Limits to check
The Free plan costs nothing and provides the REST API for rendering. Rendering does not send messages, and the mj-button component is not fully clickable because of email-client support.
The verdict
MJML provides a code-focused route from markup to responsive email HTML, with editor, CLI, and API options. Plan separately for sending the rendered output, and account for the button limitation.
Questions people ask
Is MJML free and open source?
Yes. MJML is open source under the MIT license, and its Free plan is free.
Which platforms can run MJML?
MJML supports API, extension, Linux, macOS, web, and Windows workflows. Local installation uses npm on macOS, Linux, and Windows.
Does MJML send emails?
No. After rendering MJML into HTML, you must send the result through an email service provider or directly from a shell.
What does an MJML API account include?
Each account receives one Application ID and two API keys: a public key for browser use and a secret key for back-end use.
Can I extend MJML?
Yes. MJML provides reusable, extensible components and lets users build custom components.
What the maker publishes
- API
- The MJML REST API is free to use and renders MJML into responsive HTML. source
- API authentication
- Each API account receives one Application ID and two API keys, with public and secret keys intended for browser and back-end use respectively. source
- API response
- API render responses contain generated HTML, the MJML source used, the transpiler version and possible markup errors. source
- Browser SDK
- The mjml-browser package compiles MJML in a browser context and returns generated HTML and diagnostics. source
- CLI
- The command-line tool compiles files, writes HTML or stdout, watches files, supports minification and can process allowlisted includes. source
- Client limitation
- The mj-button component is not fully clickable because of email-client support. source
- Command line
- The CLI can compile files, watch for changes, and write generated HTML to a chosen file. source
- Component model
- Built-in reusable components include sections, columns, text, images, buttons, social elements, accordions, carousels and heroes. source
- Components
- MJML provides reusable, extensible components and lets users build custom components. source
- Current owner
- LinkedIn describes Mailjet as a Sinch product. source
- Custom components
- Developers can create and register their own MJML components through configuration files and JavaScript modules. source
- Desktop app
- The separate MJML App repository distributes an Electron desktop editor with platform-specific releases and source-build instructions. source
- Documentation depth
- Documentation covers component attributes, CLI options, Node usage, browser usage, JSON input, custom components, tooling and compatibility charts. source
- Editor integrations
- Official documentation lists Visual Studio Code and Sublime Text plugins, plus Gulp integration and Open VSX availability. source
- Editor plugins
- MJML offers plugins for Visual Studio Code and Sublime Text, plus a desktop app. source
- Founded
- 2015 source
- Independent score
- FAUN.dev gives MJML an 83/100 community score, with strongest results for pricing transparency and maturity and weakest results for components and templating. source
- Installation platforms
- The official download instructions support installation with npm on macOS, Linux and Windows. source
- Integrations
- The documented ecosystem includes Mailjet, Parcel, IntelliJ IDEA, Gradle, Neos CMS, and Easy-email. source
- License
- The main MJML repository is released under the MIT license. source
- Limit: breakpoint model
- Topol reports that MJML uses a default 480-pixel breakpoint, making desktop-versus-mobile layouts easier than multi-tier tablet-specific designs. source
- Limit: generated boilerplate
- Topol notes that a short MJML document can compile into much larger HTML containing nested tables, Outlook conditional blocks and media queries. source
- Limit: no application logic
- Alterable says MJML itself has no loops, conditions or data logic, so teams need a separate templating layer or ESP processing step. source
- Limit: Outlook workarounds
- The same G2 reviewer said extra work is still needed to make Outlook behave correctly. source
Checked against the maker's pages on 15 Oct 2026.