Let’s celebrate! The Joomla! Project is pleased to announce the release of Joomla 5.3.1. This is a bugfix release for the 5.x series of Joomla.
These releases continue Joomla’s high standards in accessible web design, highlighting Joomla's values of inclusiveness, simplicity and security into an even more powerful open-source web platform.
Bug fixes and Improvements with 5.3.1
- Cleared miss match between default option and label in articles filter 45106
- Respect individual width/height constraints in Media Action - Resize plugin 45311
- Show correct custom fields when creating article after filtering by multiple categories 45353
- Fix wrong sequence for "#__action_log_config" table on PostgreSQL 45354
- Grammar fix pr 45247
- Fix PHP deprecation warning in mod_languages 45262
- [Installation][CLI] Fix hidden option asking 44908
- Clean Up File::upload method arguments 45244
- Fix typo in replacement event name for onUserBeforeDataValidation 45296
- Installation Development Mode info 45465
- HTTP Headers - CSP - Policy Directive: order + fancy select 45407
- sql postgresql valid json 45395
- Do not display modified url in update check 45373
- Fancy-select filter missing values 45365
- Media Manager Empty information 45322
- Clean Up File::upload method arguments 45244
- Use site timezone in action log email notifications 45381
- Update location of update sites for an extension 45388
- Allow indexing for smart search when content hasn’t space 45464
- UI bug fixes and Accessibility improvements for the media manager 45320
- Fix bug that save as copy saves an article published 45014
- Use time safe compare method in phpass library 45477
- Limit length of searchterm logging to prevent MysqliStatement error 45445
- Fix deprecation text and add Registry to StateBehaviorTrait 45437
- Installer rtl logical css 45420
- Jooa11y Plugin: Update embedded help URLs in language strings 45410
- Fix deprecated version 45400
- Fix description positioning in search bar 45325
The full list on GitHub is here: https://github.com/joomla/joomla-cms/milestone/142?closed=1
Where can I download Joomla 5.3.1?You can find all Joomla 5 downloads through the official downloads page at: https://downloads.joomla.org/cms/joomla5/
New Installations
New installation instructions and technical requirements
Upgrade
Would you like to make a tour of Joomla 5 without having to install it? We have a solution for you: Try Joomla 5.3.1 at launch.joomla.org.
How can I upgrade my site to Joomla 5.3.1?
Good news for Joomla 4.4.x to 5.x, it’s an upgrade, not a migration. Why? Two main reasons:
- Joomla 4 (J4) extensions that have removed all deprecations of code and are using up-to date Joomla code, will work in Joomla 5 (J5)
- Most others will work with the new Behaviour - Backward Compatibility Plugin enabled
The full details are found here: https://docs.joomla.org/Joomla_4.4.x_to_5.x_Planning_and_Upgrade_Step_by_Step
Note: we advise you to first test the upgrade on a copy of your production site.
You may also wonder if you have to migrate ASAP. We’ll support Joomla 4.4 until 14 October 2025 with security patches. So your site is not at risk if you don’t upgrade now. And don’t forget that some of your extensions may not be yet ready for Joomla 5 (even though most developers have done a great job offering a Joomla 5 test version for a while. You can filter by version in the Joomla Extensions Directory so you can see which are ready for J5 and which are J5 ready with the b/c plugin enabled.
For known issues with the 5.3.1 release, check the Version 5.3.1 FAQ in our documentation.
Who is Joomla! for?
Web agencies, large and small companies, online shops, bloggers, communities, and all kinds of organisations (for example, NGOs, schools, charities and governments) all use Joomla as their preferred CMS.
Joomla is written by committed volunteers. Many of those volunteers use it in their everyday web design, building and hosting. So, unlike many other systems, Joomla is built by those using it on a daily basis. That is reflected in its secure, robust nature.
Is there help for extension developers with Joomla 5?
Yes, a growing manual is aimed at those who code and maintain their extensions. The manual can be found at https://manual.joomla.org/migrations/51-52/ and is a growing work to help developers get ahead of any changes.
How can you help develop Joomla?
There are a variety of ways in which you can get actively involved with Joomla. It doesn't matter if you are a coder, an integrator, or a user of Joomla. You can join the community on Mattermost and look through the teams to join, or if you are ready, you can jump right into the Joomla! Bug Squad.
The Joomla! Bug Squad and the CMS Release Team are some of the most active teams in the CMS development process and are always looking for people (not just developers) who can help with sorting bug reports, coding patches and testing solutions. It is a great way to increase your working knowledge of the Joomla code base and also a great way to meet new people from all around the world.
You can also help Joomla development by thanking those involved in the many areas of the process. The Project also wants to thank all the contributors who have taken the time to prepare and submit work to be included in the Joomla CMS and Framework.
Where can I find documentation about Joomla 5?
There are some tutorials to help you with Joomla 4/5. You can find the existing ones, like creating a Plugin or a Module for Joomla 4/5, namespaces conventions, prepared statements, using the new web asset classes and many more in https://docs.joomla.org/Category:Joomla!_5.x
We encourage developers to help write the documentation about Joomla 5 on docs.joomla.org to help and guide users and other extension developers.
A JDocs page will help developers to see the existing documentation and the documentation still needed.
We invite you to check it regularly, update it and provide the missing content.
Related information
If you are an extension developer, please make sure you subscribe to the extension developer channel https://joomlacommunity.cloud.mattermost.com/main/channels/extension-development-room
Where you can join the community of extension developers.
A Huge Thank You to Our Volunteers!
Joomla 5.3.1 results from thousands of hours of work by dozens of volunteers.
A big thank you to everyone who contributed to Joomla 5.3.1!
Full details are on GitHub
Thank you all.
Translations
German: Joomla! 5.3.1 als Bugfix-Release veröffentlicht
Turkish: Joomla 5.3.1 Hata Düzeltme Sürümü