article-links
Accessible Links
Select a link in a document and your browser opens the linked document, either in the same window, a new window or a new tab. A person using a screen reader my be navigating by links alone so link text needs to be meaningful.
The following is an example of bad practice.
To find out more, click here
The following is an example of good practice:
To find out more, read our Manifesto
To find out more about accessible links see this article on Creating valid and accessible links.
Insert an External Link
For an external link you will need to copy the link to the clipboard from the url bar of your browser. For this purpose it is helpful to have separate windows or tabs open for your Joomla administrator Articles: Edit form, your Joomla site article view and the remote site you are creating a link to.
Open your article for editing. There are several methods available for link creation. One method is to type in sentence that contains the text to be used for the link text. For example:
For more information, please visit the Joomla! website.
Then:
- Select the word or words to be linked, in this case
Joomla! website
. - either Select Insert → Link from the Article Text menu.
- or double click the selected text to open a popup menu that contains a link icon to select.
Either method will open an Insert/Edit Link dialog box:

In the Insert/Edit Link dialog:
- In the
URL
field, paste the link copied from the destination window url bar. - The
Text to display
field should contain the text you selected before opening the dialog. If not, any text you type here will be inserted into the article so needs to be something that makes contextual sense. AvoidClick here
orRead more
. - The
Title
field creates a link Title attribute but its use by browsers is inconsistent and controversial for accessibility purposes. If in doubt, leave it blank. - The
Rel
field has a number of options. If in doubt, leave it set toNone
. There is a list of options available in the mdn web docs article on HTML attribute: rel - The
Open link in...
field is a simple choice betweenCurrent Window
andNew Window
. The browser settings control whether that results in a new separate window or a new tab. - Save
After saving the article, switch to the site view and check that the link looks good and works properly. Also, try it with a Screen Reader!
Insert an Article Link
The process to insert a link to an article in the same website is similar up to the point where the link text is selected. For example:
- Type in the sentence containing the link text:
For more information, please see the Typography page.
- Select the link text:
Typography
- From the
CMS Content
drop-down list selectArticle
. - An Article dialog appears with a list of articles. Select the Typography article title.
Save the article and try it out in the site view.
Remove a Link
The easy way:
- Click on the link.
- Select the ellipsis icon (...) to open the editor's expanded menu.
- Select the
Remove Link
icon.
The text remains but the link is gone.
An alternative:
- Double click on the link.
- Select the Link icon in the small popup.
- In the Insert/Edit Link dialog, delete the content of the URL field.
- Save
The text remains but the link is gone.