Mautic Community Forums

Getting ready for Mautic 4 - all details & timelines!

We’re getting ready to prepare Mautic 4! This will the fourth major release of Mautic, with some exciting new features, like the Mautic Marketplace and New Email Builder!

:warning: We need your help!

The more community contributions we get (code, documentation, etc.), the more awesome features we can bring to our users. More on that in the “How can I contribute?” section below.

Table of contents

Expected features

  • Mautic Marketplace (Beta)
  • New Email Builder
  • PHP 8.0 support Bumped to 4.1
  • Symfony 4 upgrade
  • Native Composer support
  • Cypress automated tests


Dates What
March 26 - 28 Mautic 4 Alpha Sprint (Completed!) :tada:
April 23 - 25 Mautic 4 Beta Sprint
May 14 - 16 Mautic 4 Release Candidate Sprint
May 21 - 23 Mautic 4 General Availability Sprint
May 24 June 28 Mautic 4 release :heart_eyes:

Alpha Sprint (March 26 - 28) - Completed :tada:

This is our very first Mautic 4 sprint. This will be all about laying the technical groundwork for Mautic 4 to build new features on. Without going into too much detail here, the most important aspect here is upgrading our technical dependencies (like Symfony). You likely won’t see new features yet in this sprint.

Required skill sets:

  • Developers (code + review)
  • Technical writers (documentation), to update our developer docs and user-facing docs where applicable. There will be breaking changes that we need to document!

Beta Sprint (April 23 - 25) - Completed :tada:

In this sprint, we’ll get more focused on user-facing features. It’s probably the most exciting of them all, because some shiny new functionality will come to life here! It also means that we’ll need more different skill sets.

Required skill sets:

  • Developers (code + review)
  • (non-technical) Writers for end-user facing documentation (“how does feature X work, how can I use it best?”)
  • Technical writers for developer documentation (walking through the existing docs, creating demo plugins, testing the API, all to verify if our docs are up to date)
  • Marketers to test the new features and help us prepare the communication strategy/material for Mautic 4

Release Candidate Sprint (May 14 - 16) - Completed :tada:

This sprint will be for fixing rough edges in Mautic 4. It’s the most crucial one, because it’s the final sprint before the general release. Smoke testing is key here. We’ll also be extensively testing the upgrade path for Mautic 3 to 4. In short: getting ready for release!

After this sprint, no further features and/or bug fixes will be considered (“freeze period”), except for critical, release-blocking bugs.

Required skill sets:

  • Same as the Beta Sprint
  • Testers! Both technical and non-technical. Test as many aspects of Mautic as possible, and try to break things on purpose. We want Mautic 4 to be bullet-proof! Who doesn’t want to do that? :smiley:

General Availability Sprint (May 21 - 23) To be rescheduled

These are the final days before release (May 24 June 28). We’ll prepare all marketing and support channels for the release. There shouldn’t be any more release-blocking bugs at this point, but the sprint can act as a buffer for final bug fixes in the worst case.

Required skill sets:

  • Same as the Release Candidate sprint, but a focus on marketers and technical support

How can I contribute?

  • Join us in Slack on #Mautic-4 (get an invite at
  • Take a look at the sprint planning document here - this will be a living doc throughout the entire release process with the currently active sprint at the top of the page
  • Join the kick-off calls - we hold one at 10am CEST and 4pm CEST, and a wrap up call at 8pm CEST on each day of the sprints
  • Take a look at the sprint board (if you need access to Jira please ask in the Mautic 4 channel on Slack) and assign yourself to any tasks - please ping in Slack so we can ensure that work is not being duplicated!

How can install Mautic 4 via docker?

1 Like

It isn’t released yet, so you can’t, afaik. If you want to be testing then please use ddev locally and join #mautic-4 on Slack ( too keep up to date.

We have a sprint this weekend if you’d like to help with the docker image?


Hello mam…
To be done Now released Mautic 4?

1 Like

Hi @jaypatel5213 !

We released 4.0-beta last week - see Release Mautic Community 4.0.0-beta · mautic/mautic · GitHub for the release notes.

We are running late with the releases due to the very small number of people who are helping with testing, fixing bugs etc.

Please help by testing the beta version locally in a development environment and reporting any bugs you might find at (check first to make sure they are not already reported) and join #mautic-4 on Slack ( for an invite)


What about Mautic 4.0 for now? When can you release it soonest?

Many thanks for everybody’s work!

1 Like

Hey there!

Realistically we are looking at a Release Candidate possibly around the 14th June and the full release after Mautic Conference Global, probably around the 28th June.

Sorry for the delay but we have some bugs that need to be fixed and a couple of issues with the builder which need to be addressed, and a very small number of folks working on it (who are also working on Mautic Conference Global!).

Please join #mautic-4 on Slack if you want to get involved! ( to get an invite!).


A post was split to a new topic: Create the campaign event while creating campaign through API

Hi folks,

A brief update:

While making the Release Candidate release this evening, we have come up against a fatal error with testing the upgrade (which happens as part of the release) - this appears to relate to the removal of support for OAuth1.

We are looking into a fix for this, until there is a fix we are unable to make the release.

Please bear with us while we work through this issue!


Hi folks!

Big thanks to Lukas Sykora and @dennisameling for troubleshooting the issue that was blocking our release pipeline!

Mautic 4 Release Candidate is now available for testing: Release Mautic Community 4.0.0-rc · mautic/mautic · GitHub

If all goes well with testing we are planning to make the General Availability release this time next week.


Note: If using a database prefix you may encounter an error on upgrading. If so please follow the steps outlined here: Upgrading from the last v3 to 4rc gives me a schema error relating to oauth · Issue #10232 · mautic/mautic · GitHub.

1 Like

I am also getting the following schema error when trying to upgrade t 4rc which also appears related to oauth1

[2021-07-05 12:11:14] mautic.NOTICE: Doctrine\DBAL\Schema\SchemaException: There is no table with name ‘mauticdb.oauth1_access_tokens’ in the schema. (uncaught exception) at /config/www/mautic/vendor/doctrine/dbal/lib/Doctrine/DBAL/Schema/SchemaException.php line 34 while running console command doctrine:migrations:migrate

Stuggling to add the logs in the fourm, so created a bug report in github → Upgrading from the last v3 to 4rc gives me a schema error relating to oauth · Issue #10232 · mautic/mautic · GitHub

1 Like

Thanks for letting us know! Will follow up in the issue :slight_smile:

Hello folks,

An update for those of you keenly awaiting a release today … I’m sorry to disappoint you but we still have some outstanding issues which need to be addressed before we can make the release.

Unfortunately we simply do not have enough developers and testers picking up these issues which means that we are not able to make the progress we need in order to make the release.

For reference, here are the issues:

  1. Fix installer exception handling - :arrow_right: PR needs testing Fix Installer Exception Handling - TPROD-194 by mabumusa1 · Pull Request #9934 · mautic/mautic · GitHub
  2. Fixes for dynamic content in the GrapesJS builder and refactoring of the codebase Refactor and small optimization for dynamic content html (part 2/2) by adiux · Pull Request #10114 · mautic/mautic · GitHub (some outstanding issues to be resolved early next week unless other Javascript developer/s are able to help!)
  3. Add button block for landing pages in the GrapesJS builder: :arrow_right: PR to test: Button block to the landing page added by disha-pishavadia24 · Pull Request #7 · mautic/grapesjs-preset-mautic · GitHub (needs to be reviewed / tested)
  4. Docker install / upgrade process :arrow_right: PR needs to be reviewed and tested: Mautic 4 container updates by thinkl33t · Pull Request #196 · mautic/docker-mautic · GitHub
    7. :white_check_mark: Fix email issue that was introduced recently in Amazon SES API Email sender name not changing · Issue #9751 · mautic/mautic · GitHub (PR needs testing: Email sender name not changing by MarketSmart · Pull Request #10222 · mautic/mautic · GitHub)
    3. Fix issue with pushing translations to Transifex: Error thrown when pushing translations to Transifex · Issue #10230 · mautic/mautic · GitHub :white_check_mark: Needs to be tested to confirm it was a user error :woman_facepalming:
    2. :white_check_mark: Fix issue with API tests failing: Error in API Library tests relating to GrapesJS builder · Issue #10231 · mautic/mautic · GitHub :arrow_right: PR needs automated test coverage to be increased before it can be merged: Fix yes/no button for emails by kuzmany · Pull Request #10023 · mautic/mautic · GitHub
    If you or your organisation have any capacity to help us with development or testing, please join #mautic-4 on Slack (Mautic Community On Slack for an invite) and make yourself known.

When we have a clearer idea of timelines, we will make an updated release date known.

We do really appreciate the frustration of having the dates keep getting pushed back, but we do not want to make a release which we know introduces bugs that would cause you problems.


@rcheesley and everyone else contributing take as much time as you need to do it properly. The worst thing that can happen is to make available a buggy release especially a major version release.
Unfortunately don’t have time to contribute with testing but I highly appreciate everyone working on this.


Thanks @poetry - we are going as fast as we can! It’s a challenge when folks are super busy in their work, as there is less time available for community contributions … on top of covid, holidays etc. We are making progress though thanks to some folks stepping up to help so hopefully not too far away!

1 Like

I’m sure you get this all the time but I want to ask… All online sources showing a potential date for the General Release of 4.0.0 are old dates. Any thoughts on when we could look forward to seeing the General Release?

I’m eager for the fixes to the builder. So far, in our testing, everything about the RC is working great, with the exception of builder issues.

Anyone can provide us to Installation script?

You can test with the Release Candidate but there are known issues we are working on - see Release Mautic Community 4.0.0-rc · mautic/mautic · GitHub (read the release notes!).

@PowerBoot I am just back from vacation, but we have I believe three PRs which are blocking the release. I will catch up with the Product Team today and should then have a better idea of timelines!