• 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
    • Documentation
    • Training
    • Certification
    • Site Showcase
    • Announcements
    • Blogs
    • Magazine
    • Community Portal
    • Events
    • User Groups
    • Forum
    • Service Providers Directory
    • Volunteers Portal
    • Vulnerable Extensions List
    • Developer Network
    • Security Centre
    • Issue Tracker
    • GitHub
    • API Documentation
    • Joomla! Framework

Joomla!

Download
Launch
  • Joomla Documentation
  • User Manual
  • Jobs To Do
  • Contributors
  • Re-structure

Documentation

General documentation category. With some custom fields.

1.0 Logging in in the Administrator Side

The administrator area is the area that controls all aspects of a Joomla website such as: creating menus and content; installing site features; controlling access. A site owner has control of the entire administrative area and may create accounts for other users, configuring their access for specific responsibilities such as creating, editing, or approving content. This tutorial describes how users log in to the administrator area.

Prerequisites

You must have an administrator account, either as the site owner (e.g. if you just created a new site), or as provided by the site administrator. You will need a username and password. There will be other tutorials for building a site with Joomla.

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

  1. Open a browser and navigate to the login screen 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.
  3. To log out, select Log Out from the User Menu in the header.
Screenshot of the administrator login screen showing username, password, and login button
Administrator login screen
Screenshot of the administrator dashboard with the user menu extended and the log out link being clicked
Administrator logout screen

Concepts

  • Administrator side.
  • Navigating to the login screen. It's important to note that the administrator login screen is different than the non-administrative login form you may see on site pages.
  • Logging in with your username and password.
  • Logging out.

Article in current user manual

  • https://docs-core.sandbox.joomla.org/user-manual/getting-started/getting-started-logging-in-to-joomla

2.0 First steps with articles, menu-items and categories

What are articles, menu-items and categories, and how are they related?

2.1 Creating an article and publishing under a menu-item
2.2 Creating a category
2.3 Menu items for a category of articles
2.4 featuring articles on the home page
2.5 save to menu

 

2.1 Creating an Article and Menu Item

 Add content to your website by creating an article (web page) and adding a link to it so visitors can find it in the main menu.

Prerequisites

Administrator access to a Joomla site (version 5 or above). See 1.0 Admin Login.

Adding an article and publishing it under a menu-item

In this tutorial we will add a simple menu item that displays the article we create.

In this tutorial you will be working in the administrative dashboard of your site (backend) while occasionally viewing the site as visitors see it (frontend). Click the Open frontend link in the header to open it in a new tab. Switch between tabs to work with the frontend and backend.

Screenshot of the admin dashboard highlighting the open-frontend link
Link to the frontend of the website (opens in a new tab or window)


 

Steps

  1. Login to Joomla as an administrator and navigate to the Home Dashboard.
  2. View the frontend of the site by clicking on the link on the right side of the header.
  3. Find the main menu and note the menu items. In step 8 and later we will be adding a new menu item.
  4. In the left side menu, expand Content and click on Articles.
  5. Click on the New button. A new-article form appears.
  6. Enter a title (required) and some content in the Article Text area. 
  7. Save and close
  8. In the left-side menu, expand Menus and click on Main Menu.
  9. Click on the New button. A new-menu-item form appears.
  10. Enter a title (required).
  11. In Menu Item Type click the Select button. From the popup, expand Articles and select Single Article.
  12. In Select Article click the Select button. From the popup select the article you just created.
  13. Save and close
  14. Visit your site by clicking on the visit-site button in the header.
  15. Find the link to your article in the Main Menu and follow it to view your article.

Concepts 

  • Articles in Joomla are the main content types on a web page and can display text and images.
  • A menu item is a link to an article, grouped with other links in a menu.
  • In this tutorial we only had links to individual articles. This is called a menu item type of Single Article. In later tutorials we will see other menu item types.

Articles in current user manual

  • Adding an Article
  • Adding a Menu Item

2.2 Creating a Category and Sub-Category

Joomla organizes web content by a category hierarchy. Categories are like outlines, giving structure and organization to web content.
Each article is associated with a single category or sub-category. Menu elements then leverage categories to easily create lists of articles, blogs, and more. This tutorial describes how to create categories and sub-categories. 

Prerequisites

Administrator access to a Joomla site (version 5 or above). See 1.0 Admin Login.

Creating a category and sub-category

Steps

  1. Login to Joomla as an administrator and navigate to the Home Dashboard.
  2. In the left side menu, expand Content and click on Categories.
  3. Click on the New button. A new-category form appears.
  4. Enter a title then Save & Close. The categories list returns with your new category added.
  5. Add a sub-category. Click on the New button again.
  6. Enter a title, and select a parent category in the Parent field, then Save & Close. The categories list returns with your new category added as a sub-category.
Screenshot of the category list
Navigating to the new-category form
Screenshot of the new-category form
Adding a new category

Concepts 

  • Articles are organized by categories in Joomla, giving structure to your website, making them easier to find and assisting in navigation. 
  • Sub-categories may have sub-categories.

2.3 Menu items for a category of articles

Articles grouped by category can be quickly and easily displayed on your website. This tutorial explores two types of layouts, the Category Blog Layout, and Category List layout. The Category Blog Layout presents articles in a rich layout where each article is displayed with its title, an optional image, article details (such as the author or publication date) and either the full text of the article or an article teaser and Read More link. The Category List layout displays a simple list of article titles that link to the article. 

This tutorial demonstrates how to create both layout types. 

Prerequisites

  • Create two or more articles with a common category.
    • 2.1 Creating an article and menu item
    • 2.2 Creating a Category and Sub-Category
  • Log into Joomla as an administrator.
  • From the administrator home page, open the frontend of your site using the link on the right side of the header.
    • This link will have your site name, and hovering over it will indicate that it opens the frontend.
    • The link will open the frontend in a new tab or window. 
    • Keep both these tabs open as the tutorial will have you switch between them.
  • In the frontend, find the main menu and note the menu items. We will be adding two items here.

Creating a Menu Item for a Category of Articles

This tutorial uses standard Joomla test data in which there are three articles in a category called Joomla.  We'll be making a menu item called Joomla Article Blog and Joomla Article List that will display these articles on our website. The tutorial uses the same articles and category to create both layouts (so only one set is required).

You should choose a category and menu item names that make sense for your site. Make sure there are two or more articles in your chosen category so you can see the result, and each article should contain a couple of paragraphs of content (lorem ipsum is fine).

Screenshot of a Category Blog layout
Category Blog Layout
Screenshot of a Category List layout
Category List Layout

Create a Category Blog Layout

The Category Blog menu item creates a page that displays a list of articles in a blog type layout. Each article includes an image, article details (e.g. author name and publication date), and the text of the article. 

Steps

  1. In the left side menu of the administrator homepage, expand Menus and click on Main Menu.
    • A list of menu items is displayed.
  2. Click on the New button.
    • A new-menu-item form appears.
  3. Enter a title (required).
    • We chose Joomla Article Blog but you should choose a name that makes sense for your site.
  4. In the Menu Item Type field click the Select button.
    • A popup form appears.
    • Expand Articles then click on Category Blog.
    • The popup disappears.
  5. In the Choose a Category field select your chosen category from the popup form.
    • We Chose the Joomla category but you should choose the category that makes sense for your site.
  6. Click Save & Close.
    • The form closes and your new menu item appears in the list of main menu items. 
  7. Switch to the frontend.
  8. Refresh the page then find the new link in the Main Menu. Click to follow it to view a blog layout of the articles in your chosen category.
    • Clicking on the title of any article will take you to the full article.
Screenshot of the category blog menu form
Menu item configured for type Category Blog with title and category

Adding Read-More Links

Displaying the entire article in the blog layout often isn't practical; what's usually wanted here is the first part of the article, a teaser or taster, and then a Read More link that can be clicked to view the full article. Here's how to do that.

Steps

  1. Return to the backend.
  2. Edit one of your articles by clicking on Articles under Content and then clicking on one of your articles.
  3. Insert your cursor below the text you want to appear in your teaser taster (and above the remaining text in the article).
    • Add a new line between paragraphs if necessary.
  4. In the editor toolbar, pick Read More from the CMS Content dropdown.
    • Note that a red dotted line appears.
  5. Click the Save & Close button to save the article.
  6. Return to the frontend and refresh your page. Note that a Read more button appears under the teaser taster text.
    • Clicking on the link will take you to the full article. 
Screenshot of article in blog layout with no read-more button
Full article is displayed before a Read more button is added
Screenshot showing positioning for read-more link
Edit the article and position the cursor at the desired location
Screenshot showing the read-more link being inserted from the menu
Insert the Read more link
Screenshot showing the read-more link as a dotted red line in an article
The Read more link appears as a dotted red line in the article
Screenshot showing the article with a read-more link
The Read more link in the article on the category blog page after editing the article.

Creating a Category List Layout

The Category List menu item creates a page that displays a list of articles in a simple list. Clicking on the title of an article takes you to the full article. 

Steps

  1. Return to the backend.
  2. In the left side menu, expand Menus and click on Main Menu. A list of menu items is displayed.
  3. Click on the New button. A new-menu-item form appears.
  4. Enter a title (required).
    • We chose Joomla Article List but you should choose a name that makes sense for your site.
  5. In the Menu Item Type field click the Select button.
    • A popup form appears.
    • Expand Articles then click on Category List.
    • The popup disappears.
  6. In the Choose a Category field select your chosen category from the popup form. We chose the Joomla category but you should choose the category that makes sense for your site.
  7. Click Save & Close.
    • Your new menu item appears in the list of main menu items. 
  8. Return to the frontend and refresh the page.
  9. Find the new link in the Main Menu and follow it to view a list layout of the articles in your chosen category.
    • Clicking on the title of any article will take you to the full article.
Screenshot of the category list form
Menu item configured for type Category List with title and category

Concepts 

  • This tutorial demonstrates a powerful capability of Joomla. By organizing your articles by category you can easily and quickly make lists of those articles available in either a blog format or as a simple list.
  • The nature of the menu link determined the layout; the same articles and category were used for both.
  1. 2.5 Save to Menu
  2. 3.0 Wysiwyg editor
  3. 3.1 Bold, Italic and more
  4. 3.2 Headings

Subcategories

User Guides

User Documentation, also known as The User Manual.

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

  • Joomla! on Twitter
  • Joomla! on Facebook
  • Joomla! on YouTube
  • Joomla! on LinkedIn
  • Joomla! on Pinterest
  • Joomla! on Instagram
  • Joomla! on GitHub
  • Home
  • About
  • Community
  • Forum
  • Extensions
  • Services
  • Docs
  • Developer
  • Shop
  • Accessibility Statement
  • Privacy Policy
  • Cookie Policy
  • Sponsor Joomla! with $5
  • Help Translate
  • Report an Issue
  • Log in

© 2005 - 2025 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.