--- title: "Links Best Practices" slug: "links-best-practices" description: "Find out how to make links accessible by using clear, descriptive text that conveys link purpose to improve usability and comply with WCAG guidelines." updated: 2026-03-17T17:35:43Z published: 2026-03-17T17:35:43Z canonical: "www.civicplus.help/links-best-practices" --- > ## Documentation Index > Fetch the complete documentation index at: https://www.civicplus.help/llms.txt > Use this file to discover all available pages before exploring further. # Links Best Practices The article will explain how **links** can be made compliant/conformant to help increase accessibility for users. ## Link Purpose (Directional) Replace directional link text (for example, click here or to the left) with text indicating where the link will direct the user. ### Directional Link Examples - **Good Example:** [Municipal Websites Central Help Center](/municipal-websites-central/en) - **Bad Example:** For the Municipal Websites Central Help Center, click [here](/municipal-websites-central/en). --- ## Link Purpose (In Context) The purpose of each link should be determined from the link text alone or from the link text together with its programmatically determined link context, except where the purpose of the link would be ambiguous to users, in general, to be in compliance with the WCAG Level A. --- ## Link Purpose (Link Only) A mechanism should be available to allow the purpose of each link to be identified from the link text alone, except where the purpose of the link would be ambiguous to users in general to follow WCAG Level AAA compliance. Links that are not in sentences should also be named intuitively. ### Link Purpose Examples - **Good Example**: Learn more about [Municipal Website design](https://www.civicplus.com/municipal-websites/). - **Bad Example**: For more information about local government web design, visit [Municipal Websites That Foster Civic Engagement](https://www.civicplus.com/municipal-websites/). --- ## Email Links Ensure emails and links are masked. - **Example**: janedoe@civicplus.com should be replaced with "[Email Jane Doe](mailto:janedoe@civicplus.com)." --- ## Resources - [Web Content Accessibility Guidelines (WCAG) Guideline 2.4.4: Link Purpose (In Context)](https://www.w3.org/TR/WCAG21/#link-purpose-in-context) - [WCAG Guideline 2.4.9: Link Purpose (Link Only)](https://www.w3.org/TR/WCAG21/#link-purpose-link-only) Web Content Accessibility Guidelines. A part of a series of web accessibility guidelines published by the Web Accessibility Initiative (WAI) of the World Wide Web Consortium (W3C), the main international standards organization for the Internet. ## Related - [Create Link Text](/create-link-text.md) - [Best Practice: Linking Documents](/best-practice-linking-documents.md) - [Set Hyperlink to Open in Same Window vs. New Window](/set-hyperlink-to-open-in-same-window-vs-new-window.md)