Releases: mautrix/whatsapp
v25.10
Release post: https://mau.fi/blog/2025-10-mautrix-release/
- Switched to calendar versioning.
- Added support for bridging event edits.
- Fixed backfill creating incorrect disappearing timer change notices.
- Fixed previous messages not being marked as read when sending a new message.
- Fixed incoming call notices with LID addressing going into different DM room.
v0.12.5
Release post: https://mau.fi/blog/2025-09-mautrix-release/
Another reminder about the @lid migration WhatsApp is doing that was mentioned in the v0.12.0, v0.12.2 and v0.12.3 release notes: the registration.yaml file must have .+ (or .*) instead of [0-9]+ in the user ID regex, e.g. @whatsapp_.+:example\.com. If you set up the bridge prior to v0.5.0 and do not fix your registration file, group chats will gradually stop working as WhatsApp migrates them to use LIDs. See the troubleshooting page for more details.
- Removed legacy provisioning API and database legacy migration. Upgrading directly from versions prior to v0.11.0 is not supported.
- If you've been using the bridge since before v0.11.0 and have prevented the bridge from writing to the config, you must either update the config manually or allow the bridge to update it for you before upgrading to this release (i.e. run v0.12.4 once with config writing allowed).
- Added support for changing group name/topic/avatar from Matrix (thanks to @Petersmit27 in #834).
- Added
RedactedPhoneplaceholder for displayname templates. This allows community announcement groups (where you can't see participants phone numbers) to have better names than random numbers. - Added support for
com.beeper.disappearing_timerstate event, which stores the disappearing setting of chats and allows changing the setting from Matrix. - Added lottieconverter to Docker images to enable converting animated stickers from WhatsApp.
- Added support for creating WhatsApp groups.
- Fixed sent PNGs not being rendered on WhatsApp iOS.
v0.12.4
Release post: https://mau.fi/blog/2025-08-mautrix-release/
- Deprecated legacy provisioning API. The
/_matrix/provision/v1endpoints will be deleted in the next release. - Bumped minimum Go version to 1.24.
- Added support for bridging HD dual uploads from WhatsApp into edits on Matrix.
- Added better placeholders for pin and keep messages from WhatsApp.
- Fixed bridging animated webp stickers to WhatsApp.
- Note that non-square stickers may appear corrupted on native clients. The bridge will not automatically add padding to animated stickers like it does for static ones.
- Fixed avatar changes not reflecting on both the LID and phone number ghost of a given user in certain cases.
- Fixed first message after group LID migration still using the phone number ghost.
- Fixed bot messages in DMs being split into another portal room.
- Fixed new group members not having a phone number name in some cases.
v0.12.3
Release post: https://mau.fi/blog/2025-07-mautrix-release/
- Further improved support for
@lidusers.- N.B. As mentioned in the v0.12.0 and v0.12.2 release notes, old registration files may have
[0-9]+in theusersregex. You must change it to.+, as the newlididentifiers are bridged aslid-<number>instead of just<phone number>.
- N.B. As mentioned in the v0.12.0 and v0.12.2 release notes, old registration files may have
- Added automatic conversion when sending quicktime/mov videos to WhatsApp.
- Fixed disappearing message timer not automatically fixing itself in some cases.
- Fixed call notices being sent to DM portal even if the call was in a group.
v0.12.2
Release post: https://mau.fi/blog/2025-06-mautrix-release/
- Improved support for
@lidusers.- N.B. As mentioned in the v0.12.0 release, old registration files may have
[0-9]+in theusersregex. You must change it to.+, as the newlididentifiers are bridged aslid-<number>instead of just<phone number>.
- N.B. As mentioned in the v0.12.0 release, old registration files may have
- Updated Docker image to Alpine 3.22.
- Fixed network errors on first connect not triggering automatic reconnect.
- Fixed animated sticker zips not being extracted when using direct media.
v0.12.1
Release post: https://mau.fi/blog/2025-05-mautrix-release/
- Added prefix to identify forwarded messages on WhatsApp.
- Updated mime type of unconverted animated stickers to
video/lottie+jsonwhich is now registered with IANA. - Changed relogin command to not require entering phone number twice when using phone code login.
- Fixed outgoing messages being rejected if they replied to a fake message generated by the bridge.
- Fixed backfilling messages in existing portals after relogining.
v0.12.0
Release post: https://mau.fi/blog/2025-04-mautrix-release/
- Migrated Signal session store to use new
@lididentifiers to support future chats that don't expose phone numbers.- N.B. Old registration files may have
[0-9]+in theusersregex. You must change it to.+, as the newlididentifiers are bridged aslid-<number>instead of just<phone number>.
- N.B. Old registration files may have
- Added fallbacks for various business message types.
- Added support for bridging invites, kicks and leaves in groups.
- Re-added
invite-link,joinandsynccommands for groups. - Fixed bridging chats with Meta AI.
v0.11.4
Release post: https://mau.fi/blog/2025-03-mautrix-release/
- Fixed edits being bridged multiple times if a single chat had multiple logged-in Matrix users.
- Fixed bridging some types of business messages that were supposed to be supported (there are still some unsupported types).
v0.11.3
Release post: https://mau.fi/blog/2025-02-mautrix-release/
- Bumped minimum Go version to 1.23.
- Added support for signaling supported features to clients using the
com.beeper.room_featuresstate event. - Fixed converting voice message duration and waveform.
- Fixed padding in stickers sent to WhatsApp sometimes being the wrong color.
v0.11.2
Release post: https://mau.fi/blog/2024-12-mautrix-release/
- Added better notice when view-once messages are unavailable.
- Fixed some cases of
@liduser IDs being bridged incorrectly. - Fixed starting chats by inviting Matrix ghosts.
- Updated Docker image to Alpine 3.21.