This user guide shows the current user documentation. You can contribute to that: see under Contributors

In this user guide we have four types of documentation, following the Diátaxis system:

  • Explanations: articles about working with Joomla, ordered by subject.
  • Tutorials: step-by-step introductions into the concepts used in Joomla. We have tutorials for content management , and are working on tutorials for site building and site maintenance.
  • How-to guides: step-by step recipes how to accomplish specific things in Joomla.
  • References: help pages, summing up all possibilities of an Administrator page.

See manual.joomla.org for the developers manual for Joomla. You can do a pull request to the Github repository to improve or enhance the developers documentation.

Help wanted

Your help to improve and enhance the documentation is needed and very much appreciated! We are working on it to make contributions to the user guide as easy as possible. This is the current procedure to do that:

  • Under "Contributors" you'll find more detailed instructions and suggestions how to sign in with Joomla's Identity Portal, and what to contribute.
  • After logging in (under "Contributors"), create a new article. Don't bother about where to place it: we'll do that. Just write and submit it.

An alien bug announcing the Pizza, Bugs, and Fun of 21-22 August 2026.

Translations

In September we'll implement the system we are working on for automatic translations, with translator feedback. Then the user documentation will be available in many languages. 

We now want to focus on the content and only work on the text in English.

If you want to see translations of this manual, please look at JDocManual, made by Cliff Ford, where translations of the current user guide can be found in eight languages besides English (German, Italian, Russian, Brasilian Portuguese, Portugese, Dutch, Spanish and French). Those translations were provided by automatic, AI-assisted translation, possibly with human review afterwards. That will be the way we will do translations of the documentation in the future. At the moment, if you need translations of any page into another language, you could also use Chrome browser to translate the pages (use "Translate..." in the Chrome menu).

Origin

The content under "Explanations" of the current user guide is composed of articles that were originally in our wiki at docs.joomla.org. Two years ago they were migrated to Github Markdown and used as basis for JDocManual (a Joomla extension using documents in a Git repository) and Docs-Next (also using a GitHub repository as basis, but rendered with Docusaurus, like the developers manual does). The content of JDocManual was updated after that migration. For our user guide on this site we used the content of JDocManual as our base. We are constantly updating it. If you have anything that is missing or should be improved, please let us know.

License

All contributions to the documentation are covered by the Joomla! Electronic Documentation License.