• About us
    • Joomla Home
    • What is Joomla?
    • Benefits & Features
    • Project & Leadership
    • Trademark & Licensing
    • The Joomla Foundation
    • Support us
    • Contribute
    • Sponsor
    • Partner
    • Shop
    • Downloads
    • Extensions
    • Languages
    • Get a free site
    • Get a domain
    • User Guide
    • Training
    • Certification
    • Site Showcase
    • Announcements
    • Blogs
    • Magazine
    • Community Portal
    • Events
    • User Groups
    • Forum
    • Service Providers Directory
    • Volunteers Portal
    • Vulnerable Extensions List
    • What is Joomla Academy?
    • What is Google Summer of Code (GSoc)
    • Joomla License FAQs
    • Developer Network
    • Developer Manual
    • Security Centre
    • Issue Tracker
    • GitHub
    • API Documentation
    • Joomla! Framework
Joomla! User Documentation
Download
Launch
  • User Guide / Explanations
  • Tutorials
  • How-to Guides
  • Help pages / References
  • Contributors
  • 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
  • Command Line Interface
    • Using the CLI
    • Joomla CLI Installation
  • Components
    • Banners
  • Configuration
    • Global Configuration
    • Site Offline
    • SMTP mail and Gmail
    • Sending Email Using OAuth 2.0
    • 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
    • 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
    • Language Fallbacks
  • Local Setup
    • Local Hosting on Windows
    • Laragon Setup (Windows)
    • Local Hosting on Linux
    • Docker Setup
    • Local Test Setup
    • Raspberry Pi Installation
  • 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
    • Keep Submenus Open
    • Menu Positions
    • Split Menus
    • 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
    • Privacy Outline
    • Privacy Setup
    • Privacy Workflow
    • Cookies
  • 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
  • Scheduled Tasks
    • How to Schedule a Task
    • How to Choose a Scheduler
  • 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
    • Standard Icons
  • 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
  1. You are here:  
  2. Home
  3. Documentation

Documentation

General documentation category. With some custom fields.

1 Tutorial Introduction

  • Tutorial
  • Overview

This is a series of small tutorials to learn how to manage content in a Joomla Content Management System (CMS). It is intended to familiarise users with basic tasks and concepts by providing quick hands-on exercises. We are working on other tutorials about building a website with Joomla and about site maintenance.

Where to Work the Tutorials

To work these tutorials, you need a fresh Joomla installation with no customisation, preferably on a test site or on your local computer. How to set that up will be shown in another series of tutorials about site building. For the tutorials about content management we assume you have such a test site available. Someone can set such a site up for you, or simply start experimenting with a (free) site on launch.joomla.org.

Working in a production site is risky, and customisations can lead to different behaviours, appearances, and results.

Initial Tutorials

Examples of how to log in to Joomla and become familiar with a few basics.

  • 1.1 Admin Login: logging into the backend, the administration section.
  • 1.2 Site Login: logging into the frontend of the site.
  • 1.3 Viewing the Site: viewing the site, while working in the backend.

1.1 Administrator Login

  • Tutorial

Joomla has two login areas, the site or frontend and the administrator area, or backend which is the area that controls all aspects of a Joomla website. Site owners and administrators use the backend to configure and maintain the website and its users. Other advanced users may use the backend to create and manage content, such as creating, editing, or approving articles. This tutorial describes how users log in to the backend administrator area.

Prerequisites

  • You must have an administrator account with a username and password to a Joomla site configured for default login (sites configured for advanced login options such as Single Sign-On or Passkeys are beyond the scope of this tutorial).

Steps

Login

  1. Open a browser and navigate to the backend of your site by appending /administrator to your site's URL. For example, if your site URL is https://www.mysite.com use https://www.mysite.com/administrator.
  2. Enter your username and password, then click Log In. Result: The administrator dashboard appears.
    Screenshot of the administrator login screen showing username, password, and login button
    Administrator login screen

Explore the Layout

  1. Locate the main administrative menu on the left side of the screen.
  2. Click Toggle Menu. Result: The menu minimises. Click it again to expand the menu.
  3. Click one of the administrative menu headings. Result: The heading expands into a submenu of hierarchical items.
  4. Click one of those submenu items. Result: The main content area, to the right of the administrative menu, displays messages and commonly-used controls related to the selected item.
  5. Locate the header at the top of the screen. It contains the Joomla version number, additional messages and information, a link to the site homepage, and the user menu.

Logout

  1. To log out, select Log Out from the User Menu in the header. Result: You are logged out.
    Screenshot of the administrator dashboard with the user menu extended and the log out link being clicked
    Administrator logout screen

Concepts

The administrative area allows advanced users access to the backend to configure the site and manage users and content.

Backend users may have different permissions, allowing them to see and access different areas.

Frontend and backend logins are different. Some users can only log in to the frontend. Backend users can log in to both the backend and frontend.

1.2 Site Login

  • Tutorial

Joomla has two login areas: The administrative area, or backend used to control all aspects of a Joomla website; and the site, or frontend used by site users to interact with the site to create or update some site content, access controlled areas not available to the public, and other purposes. This tutorial describes how users log in to the site frontend.

Prerequisites

  • You must have a user account with a username and password to a Joomla site configured for default login (sites configured for advanced login options such as Single Sign-On or Passkeys are beyond the scope of this tutorial).

By default, a new Joomla installation has a login form on the site homepage.

Steps

Login

  1. Open a browser and navigate to the homepage of your site.
  2. Enter your username and password, then click Log In. Result: The login form changes, displaying your username and a Log Out button.

Depending on your access you may notice other changes, such as content only available to logged-in (or registered) users, controls to edit site components, and other differences. Some of these will be explored in other tutorials.

Login form
The frontend log in form

Logout

  1. To log out, click Log Out in the Log In form. Result: You are logged out.
Logout form and a menu only visible to logged-in registered users
In this example, a Types of Pets menu appears for logged-in users only. The Log In form shows the user name and a Log Out button.

Concepts

Joomla has two separate login areas: the frontend for site users, and the backend for administrators. This tutorial describes how registered users log in to the frontend, which is the public-facing area of the site. Registered users can log in to access controlled areas not available to the public, and to interact with site content.

1.3 Viewing the Site

  • Tutorial

The first two tutorials explain that Joomla has two login areas, a frontend and a backend, and that these are independent of each other. Future tutorials will direct you to make changes in the backend then view the results in the frontend. This tutorial will demonstrate that the frontend and backend logins are separate, and describe how to switch back and forth between the frontend and backend.

Prerequisites

  • 1.1 Admin Login
  • 1.2 Site Login

Steps

View the Frontend

  1. Open a browser and log in to the backend of the site.
  2. Locate the View Site button in the header. Hover over the button and read the tool tip that pops up.
  3. Click the button. Result: The frontend opens in a new tab.
  4. Switch between the two tabs to verify the backend is open in one, and the frontend is open in the other.
Location of the View Site icon in the header
Location of the "View Site" icon in the header.

Updates and Refreshing

Many tutorials will direct you to login to the backend, view the frontend, make changes in the backend, then refresh the frontend. We will practice this now.

  1. In the frontend and observe the title Home on the homepage.
  2. In the backend, click on Menus > Main Menu then the Home menu item. Result: The menu item edit form appears.
  3. Change the Title to Site Home Page then click the Save (not Save & Close) button.
  4. View the frontend and refresh the page. Result: The title on the homepage has changed to Site Home Page.
    Menu title on site homepage
    Work in the backend to make changes, switch to the frontend to view the results.
  5. Return to the backend. Change the Title back to Home then click the Save & Close button.

Concepts

Switching between the backend in one tab and the frontend in another is a very convenient way of making changes and observing the result.

You will be logged into the backend in one tab, but typically not logged into the frontend in the other. This has the advantage of seeing the frontend as the public would.

10 Menus

  • Tutorial
  • Overview

Menus are of course the links we use to navigate to resources in a site. These tutorials explore menus and how they can be configured.

  • 10.1 Submenus — submenus are groups of related menu items organised into a hierarchy; the menu for these tutorials is grouped by section.
  • 10.2 Split Menus — splits a menu into multiple parts to keep it from overwhelming visitors, especially on small devices.
  • 10.3 Display Options Hierarchy — display options for menus and menu items that are inherited by default but can be set independently.
  • 10.4 Adding a New Menu — creates a new menu, populates it with menu items, then displays it on a website using a site module.

Maintaining links to articles and other site resources is an important aspect of content management. Joomla menus are easy to use and customisable.

  1. 10.1 Submenus
  2. 10.2 Split Menus
  3. 10.3 Article Display Options Hierarchy
  4. 10.4 Adding a New Menu

Subcategories

User Guides

User Documentation, also known as The User Manual.

  1. You are here:  
  2. Home
  3. Documentation

  • Joomla! on Facebook
  • Joomla! on X
  • Joomla! on Bluesky
  • Joomla! on Threads
  • Joomla! on YouTube
  • Joomla! on LinkedIn
  • Joomla! on Pinterest
  • Joomla! on Instagram
  • Joomla! on GitHub
  • Home
  • About
  • Community
  • Forum
  • Extensions
  • Services
  • User Guide
  • Developer
  • Shop
  • Accessibility Statement
  • Privacy Policy
  • Cookie Policy
  • Sponsor Joomla! with $5
  • Help Translate
  • Report an Issue
  • Log in
 A Digital Public Good.

© 2005 - 2026 Open Source Matters, Inc. All Rights Reserved.

Rochen
Joomla! Hosting by Rochen
We have detected that you are using an ad blocker. The Joomla! Project relies on revenue from these advertisements so please consider disabling the ad blocker for this domain.