Links

In Document360, you can add hyperlinks to text, images, and files within your articles or category pages. Links help readers navigate between related content, reach external resources, or jump to a specific section within the same article.

Document360 supports four types of hyperlinks:

All link types are available in the Advanced WYSIWYG editor. The Markdown editor supports article links, external links, and email links, but heading/anchor links work differently.

When would you use this

• Link to a software download page using an external link so readers can access the file without searching for it
• Use anchor links in a table of contents at the top of long troubleshooting articles to let readers jump directly to the relevant section
• Link to a related article at the end of each article to guide readers to the next logical step
• Copy heading links from the knowledge base site and share them directly in support tickets to point readers to the exact section they need
• Link to a PDF guide, configuration template, or release notes document stored in Drive

Add links

Opening the add link dialog

In the Advanced WYSIWYG editor, you can open the link dialog in three ways:

• Quick insert menu — Select the desired text. When the Quick insert menu appears, click the Link icon.
• Slash command — Type /Link in the editor.
• Keyboard shortcut — Select text and press Ctrl + K.

The Add link dialog will appear with two options: Article and External link.

Article link

Use an article link to connect readers to another article within your knowledge base. You can also link to a specific heading within any article.

1. Open the Add link dialog using any of the methods above.
2. Select the Article radio button.
3. In the Text field, update the hyperlink display text if needed.
4. Select the workspace and language of the target article from the Workspace & Language dropdown. This is especially important in multi-language or multi-workspace knowledge bases.
5. Start typing the article name in the Search article field and select the desired article from the list.

6. Optionally, select a heading from the Link to a heading dropdown to link directly to a specific section within the article.
7. Select the Open in a new tab checkbox if needed.
8. Click Add.

External link

Use an external link to point readers to a URL outside your knowledge base — such as a third-party tool, a product download page, or official documentation.

1. Open the Add link dialog.
2. Select the External link radio button.
3. Enter the display text in the Text field.
4. Paste the destination URL in the URL field.
5. Select the Open in a new tab checkbox if needed. This is recommended for external links so readers do not lose their place in your knowledge base.
6. Click Add.

Internal anchor link (bookmark link)

An anchor link points to a specific heading within an article rather than the top of the page. This is also called a bookmark link or heading link. They are the same thing in Document360.

Anchor links are useful for long articles where readers need to jump directly to a relevant section.

1. Select the desired text and press Ctrl + K. The Add link dialog will appear.
2. Select the Article radio button. The Text field will auto-populate with your selected text. The Workspace & Language dropdown will show your current workspace. The Search article field will default to the current article.
3. Select a heading from the Link to a heading dropdown.
4. Select the Open in a new tab checkbox if needed.
5. Click Add.

How heading IDs work

Every heading (H2 to H6) in the Advanced WYSIWYG editor is automatically assigned a unique, permanent ID when created. This ID is based on the heading text at the time of creation and does not change — even if you rename the heading later. This means:

• Anchor links remain functional even after heading text is edited.
• If two headings share the same title, Document360 appends suffixes (_1, _2, etc.) to keep IDs unique.
• Heading IDs are consistent across language versions — the same ID is preserved in every translated version of the article.

Copying heading links from the knowledge base site

On the published knowledge base site, a Copy link icon appears next to every H2, H3, and H4 heading when you hover over it. Clicking it copies the direct URL to that section. This is useful for support teams sharing a specific section with a reader, or for linking directly from external tools.

Email link

An email link opens the reader's default email client with the address pre-filled.

1. Select the desired text and press Ctrl + K. The Add link dialog will appear.
2. Select the External link radio button.
3. In the URL field, enter the email address in the following format: mailto:email@example.com
4. Click Add.

Linking to files (PDFs, images, Word documents)

To link readers to a downloadable file stored in Document360 Drive:

1. Upload the file to Document360 Drive.
2. Click the uploaded file to open the File details pane.
3. Under Location, click the Copy icon next to the file path to copy the file URL.
4. Go to your article, select the text you want to hyperlink, and press Ctrl + K.
5. Select External link, paste the copied URL, and click Add.

Readers clicking the link on the knowledge base site will be taken directly to the file.

Editing and removing links

To edit or remove an existing hyperlink in the Advanced WYSIWYG editor:

Click the hyperlinked text. A small toolbar will appear with four options:

• Open the link — Click to visit the linked URL.
• Edit — Modify the hyperlink text or URL.
• Unlink — Remove the hyperlink while keeping the text.
• Copy — Copy the hyperlink URL to the clipboard.

How Document360 handles internal link URLs

When you add an internal article link, the generated URL may include additional components such as the workspace version or a different domain format. For example:

• https://docs.yourcompany.com/v1/docs/article-name
• https://yourproject.document360.io/docs/article-name

These variations are expected and are handled automatically by Document360. A 404 error will only occur if the target article has been deleted, unpublished, or hidden, or if the target heading no longer exists.

Best practices

• Use article links instead of external links for content within your knowledge base — they are more stable and update correctly if the article slug changes.
• Open external links in a new tab so readers do not lose their place in your knowledge base.
• Use anchor links in long articles to help readers navigate directly to relevant sections — especially in troubleshooting guides and reference articles.
• Do not link to hidden or unpublished articles — they return a 404 error for readers on the knowledge base site.
• Limit external links to 1–3 per article for optimal SEO health. Articles with no external links or more than three are flagged under Suggestions in Document360's Health Check Metrics.
• Use internal links frequently — 1 to 3 internal links per article is considered optimal for both reader navigation and SEO performance, as indicated by the Health Check Metrics tool.

FAQ