Inserting and managing links

Plan requirement

Subscription Any plan
Access Agent

Internal links turn a pile of articles into a knowledge base. Two rules keep them working across languages and renames.

Insert a link

  1. Select the text that should be the link.
  2. Insert a link and search for the article, or paste an address.
  3. Save.

Searching for the article is better than pasting, because it produces a link that survives the article being renamed.

Rule one: leave the language out of the address

An internal link should not carry a fixed locale. A Dutch reader following a link with an English locale in it lands on the English version, and the reverse.

Zendesk redirects a locale-less link to the reader's own language, which is what you want when you translate.

Rule two: describe the destination

Link text should say where it goes. "See setting up your business hours" works; "click here" does not, and it is unusable for anyone with a screen reader scanning a list of links.

Link both ways

An article linked from nowhere is found only by search. When you write something new, add a link to it from the articles a reader would arrive at first. That takes a minute and it is what makes a knowledge base navigable.

Check them occasionally

Links break when articles are deleted or moved. Nothing warns you, and a broken link in a published article is invisible to you and obvious to your reader.

See also

Was this article helpful?

0

Still stuck?

Our support team will take a look with you.

Comments

0 comments

Article is closed for comments.