Linking to other articles
  • 02 Mar 2022
  • 2 Minutes to read
  • Contributors
  • Dark
  • PDF

Linking to other articles

  • Dark
  • PDF

You can link to another article in your knowledge base by highlighting any text in your current article and clicking on the link icon in your editor toolbar.

In the Paste URL or type to search field, start typing the name of the article you like to link. A list of matching article names will appear in a dropdown.

Select the article to link, check the box if you'd like it to open in a new tab, and then click OK in the Markdown editor or Insert in the WYSIWYG editor.

Bookmark links inside articles/category pages

Interlinking inside the article content is essential when working with long articles or category pages. Users can search for and add links to the heading (H2, H3, H4) from the same article.

The H3 and H4 tags would show up in the linking inside the article dropdown only when enabled in Settings.
Go to Settings → Article settings & SEO → Article settings → Article right. The H3 and H4 should be selected.


Just click on the hyperlink tool in either of the editors (Markdown or WYSIWYG) scroll down the overlay to find link to current article heading. Click on the dropdown and select from the Heading tags available in the article. The slug URL would be added to the Destination URL at the top, type in the Link text and click on Ok.

What happens to the hyperlinks when I do a machine translation?

When you do translation for an article, all the hyperlinks in the default language will be directed to the respective translated language in the new/draft article.

For example, you have an article in English language, and it has internal hyperlink(s). These internal hyperlinks are directed to the links in the English language. When you translate this article to French, all the internal hyperlink(s) are directed to the respective links in the French language.

Since the hyperlinks are redirected to the respective translated language, there might be a chance for broken links in the knowledge base.

It is recommended to maintain the same article slug for similar articles across all languages to avoid broken links.

For example, if you have a getting started article in the English language with slug /getting-started, maintain a similar slug in the German language as /getting-started. This is because when you add a redirect rule, the hyperlink URL text for English language is domain_name/en/article_slug and for German language is domain_name/de/article_slug

Was this article helpful?

What's Next