v26.02

Release post: https://mau.fi/blog/2026-02-mautrix-release/

• Bumped minimum Go version to 1.25.
• Added automatic recovery for WhatsApp app state sync issues.
• Fixed LID redirects for some non-message events.

v26.01

Release post: https://mau.fi/blog/2026-01-mautrix-release/

• Fixed broadcast list messages to LIDs causing split DMs.
• Fixed read receipts not working correctly in LID DMs.
• Fixed backfill sometimes racing with receiving LID mappings.

v25.12

Release post: https://mau.fi/blog/2025-12-mautrix-release/

• Updated Docker image to Alpine 3.23.
• Fixed group member invites from Matrix not automatically disinviting the phone number ghost when the invite is redirected to a LID ghost.

v25.11

Release post: https://mau.fi/blog/2025-11-mautrix-release/

• Added interface support for notifying about failed invites when creating a group and sending the invites via DM (only applicable to provisioning API).
• Added migration to automatically delete duplicate LID DM portals that were created earlier.
• Changed contact list API to only include actual phone contacts.
• Removed extra unrecognized message notice when receiving live photos (bridging the live photo video is not currently planned).
• Fixed pairing not working with latest WhatsApp Android version.
• Fixed replies, read receipts and typing notifications not being bridged correctly after DM LID migration.
• Fixed backfill creating duplicate portals if history sync contains both LID and phone number DM data.
• Fixed some cases of LID and phone number user infos getting out of sync.
• Fixed muting chat forever not being bridged correctly from WhatsApp.
• Fixed old mutes being re-applied on chat resync in some cases.
• Fixed backfilling failing if some reactions were missing sender info.
• Fixed space not being deleted when leaving community on WhatsApp.
• Fixed sticker size metadata on Matrix not matching how native WhatsApp Web renders them.
• Fixed ratelimit errors in login not being exposed to the user properly (thanks to @dead8309 in #852).

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 RedactedPhone placeholder 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_timer state 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/v1 endpoints 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 @lid users.
  • N.B. As mentioned in the v0.12.0 and v0.12.2 release notes, old registration files may have [0-9]+ in the users regex. You must change it to .+, as the new lid identifiers are bridged as lid-<number> instead of just <phone number>.
• 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 @lid users.
  • N.B. As mentioned in the v0.12.0 release, old registration files may have [0-9]+ in the users regex. You must change it to .+, as the new lid identifiers are bridged as lid-<number> instead of just <phone number>.
• 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+json which 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.