Links and Link Text

Link text should be clear, descriptive, and meaningful on its own. Readers (including those using screen readers) should understand where a link goes without needing surrounding context.

General Rules

Use these principles to ensure link text communicates its purpose and destination effectively.

• Use descriptive link text that summarizes the destination or action. For example, “For more pricing details, see the Spaces pricing page.” Avoid vague phrases like “Click here” or “Learn more”.

• Ensure link text makes sense out of context. Screen readers often let users navigate from link to link independently of surrounding text.

• Keep link text concise but informative. Focus on the content or action the user accesses (not the mechanism of clicking). For example, “Download the 2025 Report,” rather than “Click here to download.”

• Place links on meaningful nouns or phrases, not filler words, verbs with no informational value, or punctuation marks.

Consistency and Placement

Use consistent, deliberate link placement to keep documentation clear and predictable for readers.

• If several links on the same page point to the same destination, use consistent link text for each, or link only the first meaningful instance when possible.

• Avoid linking entire sentences unless doing so improves clarity, such as in notices, callouts, or procedural steps where the entire sentence represents the actionable item.