Joomla 4/5 User Manual
Joomla! 4.0 / 5.0 Tutorial
Adding a New Article
This tutorial is part of a series about working with Joomla! Articles.
It covers the methods for adding a new article after logging in to the Administrator Dashboard and is based on a standard Joomla installation using the default content editor.
For more information on the different editors available in Joomla read: Content Editors.
Before starting, in addition to the content, if you use them, you will need to know what category and any tags you will assign to the article.
- Log in to the Administrator Home Dashboard. More on this here: Logging in or out of the Administrator Dashboard.
Directly from the Home Dashboard¶
Dependant on if your Home Dashboard has been customised after installation, you will have one or two options to generate a new article:
- In the Sidebar Menu click the Content link, then from the dropdown menu click the plus (+) symbol to the right of the Articles link.
- If it is displayed, in the Home Dashboard Site Panel click the plus (+) symbol to the right of the Articles icon.
Via the Article Manager¶
Either of these options will open up a page: Articles: New that is ready for input.
Preparing the Article¶
When a new article is generated it will open a tabbed panel with the Content tab selected. It is possible to save a new article with only two pieces of required information:
- Enter a title in the Title field. This is used where ever the article title is displayed. (Required) The Alias field next to the title field is not a required field as if it is left blank Joomla will create the alias when the article is saved. The alias is used to refer to the article and is important for the Search Engine Friendly Address features. The alias may also be used by other site functionality such as plugins and modules to find the article.
- Choose a Category. See Article Settings below for more information.
- Whilst not strictly required to add and save an article, enter your content using the editor.
The other tabs above the content editor include several options or parameters for the article. You may not see all the following tabs as a Site Administrator may hide some to help maintain the consistency of article layout across the website. You may also see additional tabs for Custom Fields if they have been set up.
- Images and Links allows you to set an intro and featured image and / or links to appear in predefined positions. This may be used if your article will be displayed within a category blog.
- Options allows you to specify the layout of the article and associated information such as title, category, tags, publishing details etc. This is normally set globally but can be article specific through these options.
- Publishing allows you to set publishing dates and times to schedule publishing of an article. By default, when an article is saved it will be published straight away. You can also set the Metadata for the article.
- Configure Edit Screen allows you to show or hide parameters for the article.
- Permissions shows the permissions for each user group that control what can or cannot be done.
Besides the content, an article has settings to manage publishing, how / where it will be displayed and who can see it when published. In many cases some of these will be left at their default setting:
- Select the Status: Published, Unpublished, Archived, or Trashed - the default is Published.
- Select a Category using the drop down menu - this is a Required field. Note that although required, if you do not set it the article will still save but be set to the Joomla default category uncategorised. You can add a new category in this field by typing it in and pressing enter.
- Toggle the Featured setting on off, whether or not to display the article on the home page.
- Select the Access level for the article: Public, Registered, Super Users, etc.
- Select one or more Tags for your article. Start typing to find and select pre-defined tags or you can add a new one by typing it in and pressing enter.
- You can add a Note which will be visible in the Article Manager.
- You are also able to add a Version Note which will show in the version history for the article.
Saving the Article¶
Once you have added the required information and content you can save the article.
There are a number of ways to do this depending on what you wish to do next in Joomla.
To save the article you can choose to Save, Save&Close, Save to Menu or Save&New as follows:
- Click the Save toolbar button to save your changes. This will keep the article open. It is good practice to regularly save your work on longer articles.
- Click the Save & Close toolbar button to save the article and
take you to the Articles List. The Save & Close button has a further
two drop-down options:
- Click the Save to Menu toolbar button to add the article to a menu by opening a Menus: New Item page.
- Click the Save & New toolbar button to save the article then open up an Articles: New page. This option saves time when adding multiple articles.
A system message will indicate that the article has been successfully saved.
Errors on attempting to save:¶
- If you have not completed the required fields, a red error message will appear indicating the missing information you must add.
- You will see an error message if the article has an alias that already exists. You can overcome this by amending the alias field.
- If you are not the Super User or Administrator, take time to understand how the website is set up. Just because you have saved an article doesn't mean it is visible on the website. If Category Blog pages are being used, assigning the correct category will display the article. Otherwise an article needs to be assigned to a menu item. You can do this in the article or via Menus then Manage.
- Try to keep article titles short and specific.
- Whilst it can be done, if there are several users adding articles to the website avoid creating new categories and tags in articles. Spelling errors and differences can easily prevent articles from displaying where they were intended. Creating categories and tags in their respective list page ensures consistency across the website.
- If there is a need, make use of article notes. They can be very helpful, especially where several people add articles.
- Wherever you are in Joomla you can add an article without going to the Home Dashboard - use the Joomla Sidebar Menu.