Joomla User Guide
Getting Started
Introduction to Joomla!
Joomla Core Features
Hosting Setup
Installing Joomla
Logging in to Joomla
Articles and Categories
Adding a Category
Adding an Article
Adding a Menu Item
Adding a Module
Keyboard Shortcuts
Articles
Articles: Categories
Articles: Filter Options
Articles: Featured
Articles: Archive
Articles: Delete
Article: Edit - Content
Article: Edit - Headings
Article: Edit - Images
Article: Edit - Links
Article: Edit - Lists
Article: Edit - Tables
Article: Edit - Pagination
Article: Edit - Read More
Article: Edit - Images and Links
Article: Edit - Options
Article: Edit - Publishing
Article: Edit - Metadata
Article: Edit - Configure Edit Screen
Article: Edit - Permissions
Article: Save to Menu
Article: Versions
Article: Preview
Article: Accessibility Check
Article: Access Restriction
Article: Check-in
Banners
Banners
Command Line Interface
Using the CLI
Joomla CLI Installation
Configuration
Global Configuration
Site Offline
SMTP mail and Gmail
The htaccess.txt file
The robots.txt file
Adding www to a URL
Disallow Image Hotlinking
Disallow Directory Listing
Password Protect Directories
Contacts
Contacts
Category List Override
Dashboards
Home Dashboard
Content Dashboard
Menu Dashboard
Components Dashboard
Users Dashboard
System Dashboard
Help Dashboard
Editors
Content Editors
TinyMCE Plugin
Codemirror Plugin
HTML Filters
Extensions
Installing an extension
The Joomla Extensions Directory
Vulnerable Extensions
Fields
Fields and Field Groups
Field Parameters
Calendar Field
Checkboxes Field
Colour Field
Editor Field
Integer Field
List Field
List of Images Field
Media Field
Note Field
Number Field
Radio Field
SQL Field
Text Field
Textarea Field
Url Field
User Field
Usergroup Field
Subform Field
Multilingual Sites
Template Overrides
Help
Guided Tours
Administrator Help
Hosting & Installation
Free Hosting
cPanel Hosting
Bitnami Installation
Raspberry Pi Installation
Auto Installer Installation
Moving Installation Directory
Local Setup
Hosting Notes
UNIX File Permissions
Windows File Permissions
Multiple Domains and Web Sites in a single Joomla! installation
Sub-Domains, Parked Domains and Add-On Domains
Nginx
Apache PHP Handlers
Optional Technical Requirements
Languages
Setup a Multilingual Site
Multilingual Associations
Language Overrides
Debugging a Translation
Local Setup
Local Hosting on Windows
Laragon Setup (Windows)
Local Hosting on Linux
Docker Setup
Local Test Setup
Mail Templates
Options
Editing
Mass Mail Users
Managing Template Layouts
Tags Cross-Reference
Media
Managing Media
Upload Delete Rename
Image Crop Resize Rotate
Media File Locations
Media: Options
Uploading SVG files
Menus
Adding a New Menu
Menu Items
Menu Item Types
Menu Item Order
Submenus
Menu Positions
Auto redirect guests to login
Archived Articles
Custom Administrator Menu
Migration & Upgrade
Version Update
Migration Basics
Can I Do this Myself?
Joomla 5 to 6
Joomla 4 to 5
Joomla 3 to 4
Joomla 2.5 to 3
Joomla 1.5 to 4
Joomla 1.0 to 1.5
Modules
Site Modules
Administrator Modules
Module Positions
Module Display by Menu Item
Modules inside Articles
Login Form
Module Styles
Archived Articles
Custom Module
News
News Feeds
News Display
Performance
Page Analysis
Monitoring Server Health
Monitoring Site Speed
Accessibility Checker
Managing 404 Errors
Plugins
About Plugins
Joomla! Update Notification
Privacy Outline
Privacy Setup
Privacy Workflow
Problems
Assorted Issues
Unsupported PHP Version
FatalError
Database Table Structure
Local Host Email
Database Connection
Reference
Joomla Licenses
Joomla! Copyright
What are web standards?
Where are the web pages?
Security
Best Practices
HTTP Headers
SEO
SEO Basics
Search Engine Friendly URLs
SEF URLs on Apache
SEF URLs on Nginx
Monitoring SEO
Using A Sitemap
Schema.org
Schema.org
An Introduction to Schema.org
Schema.org System Plugin
Accessing Schema.org Custom Fields
Article BlogPosting Type
Article Book Type
Article Event Type
Article JobPosting Type
Article Organization Type
Article Recipe Type
Smart Search
Smart Search Quickstart
Smart Search on Large Sites
Smart Search Layout Overrides
Smart Search Indexing
Smart Search FAQs
Smart Search Options
Smart Search Test Plan
System
Backup
Cache
Purge Expired Cache
Top 10 Stupid Tricks
Tags
Content Tags
Templates
Template Basics
Cassiopeia Customisation
Template Overrides
Template Layouts
Child Templates
Favicons
Template SVG Logos
Cassiopeia templateDetails.xml
Switching Templates
Home Page in Different Style
Module and Menu Styles
Font Awesome Fonts
Test Installations
Visual Studio Code Primer
Visual Studio Code Extras
Setting up Apache, PHP and MySQL manually
File Permissions: Linux
File Permissions: Windows
Users
Access Control
User Registration
User Profile
User Password Reset
Admin Password Recovery
User Password Security
WebAuthn Login
Multi-factor Authentication
Guest Access
Changing User's Groups
Login and Logout Redirects
User Actions Log
Workflows
Publishing Workflow
Workflow Example 1
Workflow Example 2
Joomla User Guide
This user guide shows the current user documentation. You can contribute to that: see under
Contributors
and
Jobs To Do
. We are reorganising the menu, so it will have a more logical structure, besides the current alphabetical listing: see under
Tutorials
For the developers manual for Joomla, see
. 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:
Sign in with Joomla's Identity Portal. Under "Contributors" you'll find more detailed instructions.
Go to the "Documentation Suggestions" channel on Mattermost and ask for author-rights for your account. You can always go back to this channel for any questions or consultation about the documentation.
Under  "Jobs to do" you'll find a list of things that need to be done for the user guide. We are still working on that list.
Under "Contributors" you'll find a tutorial about how to make a tutorial.
If you want to contribute to the user guide, log in with your author-account under "Contributors" and create a new article.
Hope to see you on Mattermost and on our
Pizza, Bugs & Fun
on
January 30 and 31, 2026
. Thank you!
Translations
At the moment you don't find translations of the user guide on this site. That is deliberately left out for now, as we first want to focus on the content and only display the core 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. For translations of any page into another language, you could also use Chrome browser to translate the pages (use "Translate..." in the Chrome menu).
Origin
We are moving away from the "old" wiki at
docs.joomla.org
. The content 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.
License
All contributions to the documentation are covered by the
Joomla! Electronic Documentation License