Links signal an action that will let the user navigate to another page, view or resource, when they click or tap on them.
Links must include a descriptive link text or a combination of the text and an additional icon.
Link text should describe the assigned action as clear and short as possible (e.g. download, submit form, search).
Icons simplify user recognition and provide ability to shorten link text to a minimum. Icons should be limited to differentiate from a standard hyperlink (i.e. if it does something other than navigating to a new page). In contrast to buttons, icons are only allowed additionally to link text, not as only link signifier.
Examples of non-standard links include:
- Links that open a modal instead of a new page (e.g. map links)
- Links that open a file instead of a web page (e.g. PDF or document links)
- Links that cause something to happen that the user would otherwise not expect (e.g. play a sound, like pronunciation links)
- Links that open a new website instead of just a new page (external links)
- Links that open a non-web protocol URI (e.g.
Several Wikimedia Movement projects provide extensive “manuals of style” for applying and designing for links, for example English Wikipedia.
States of links
The link styles outlined here were designed with accessible color variations to distinguish the link’s following visually separated states (e.g. disabled, hover, active):
Links don't feature a disabled state. Consider using quiet buttons for those applications instead.
By default links are only underlined on interaction (hover, active).
To suit user preference and for accessibility reasons MediaWiki also provides a setting to always underline links.