---
title: "Link a vault to knowledge bases and set indexing policy"
description: "Choose the destination, document eligibility and indexing options for each vault link."
url: https://helpcenter.complytrain.net/en/articles/25-link-a-vault-to-knowledge-bases-and-set-indexing-policy
collection: "Documents"
updated: 2026-09-22
language: en
---

# Link a vault to knowledge bases and set indexing policy

Choose the destination, document eligibility and indexing options for each vault link.

Choose the destination, document eligibility and indexing options for each vault link.

## Create the link

Product location: `/document-vault/vaults/{vaultId}/kb-links` (fallback: `/document-vault/vaults`)

Open the vault and its **Knowledge Base Links**. Add a link, select an available knowledge base, choose the link type and check whether the link should be active. Save, then inspect the new link in the list.

A knowledge base already linked to this vault is excluded from the new-link picker. Edit its existing link to change its type or active state. Editing a link does not offer a replacement knowledge-base destination.

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Link type</p></th><th colspan="1" rowspan="1"><p>Intended use shown in the interface</p></th></tr><tr><td colspan="1" rowspan="1"><p>Primary</p></td><td colspan="1" rowspan="1"><p>Main knowledge base for document search and AI.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Secondary</p></td><td colspan="1" rowspan="1"><p>Additional knowledge base for extended search.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Archive</p></td><td colspan="1" rowspan="1"><p>Archived or historical documents.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Reference</p></td><td colspan="1" rowspan="1"><p>Reference material.</p></td></tr></tbody></table>

The link's purpose and active state are separate from which documents its indexing policy allows.

![Choose the knowledge base, link type and active status. This form has not been saved.](https://staticfiles.gleap.io/p6950dfbf97796f2087a9f022/qgpERLYubvf6h8OyXWBLdBRxP9LoiPLeg6zgx3hO6j4Eds1YsjkCBXhqiJGYmaX8JMKmdtYweCF.png "Select the purpose of the knowledge-base link")

## Configure the indexing policy

Product location: `/document-vault/vaults/{vaultId}/kb-links` (fallback: `/document-vault/vaults`)

Choose **Configure Indexing Policy** on the link. The link card summarises the saved policy.

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Option</p></th><th colspan="1" rowspan="1"><p>What to decide</p></th></tr><tr><td colspan="1" rowspan="1"><p>Indexing scope</p></td><td colspan="1" rowspan="1"><p>Choose <strong>All Documents</strong>, <strong>Approved Only</strong>, <strong>Published Only</strong> or <strong>Specific Types</strong>, according to the material that should be searchable. With <strong>Specific Types</strong>, choose the document types to include.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Index on states</p></td><td colspan="1" rowspan="1"><p>Select the document states that should trigger indexing. The editor lists draft, pending review, approved, published, archived and obsolete.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Remove on states</p></td><td colspan="1" rowspan="1"><p>Select the states that should remove material from this knowledge base's index.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Auto reindex</p></td><td colspan="1" rowspan="1"><p>Choose whether document changes should cause reindexing.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Include metadata</p></td><td colspan="1" rowspan="1"><p>Choose whether document metadata should be included.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Include content</p></td><td colspan="1" rowspan="1"><p>Choose whether the document's content should be included.</p></td></tr></tbody></table>

A new link starts with **Approved Only**: indexing on approved and published, removal on archived and obsolete, with reindexing, metadata and content included. Choose **Save Policy**, then reopen the policy to check it.

## Verify a useful result

Product location: `/document-vault/vaults/{vaultId}/kb-links` (fallback: `/document-vault/vaults`)

For an approved-only use case, choose a document whose approval state you have checked. Confirm its eligibility in the policy, then inspect the knowledge base after indexing has completed. Check a matching search or assistant answer and follow the returned source to the intended document version.

A saved link confirms configuration, not completed ingestion. Missing content can result from the link being inactive, state eligibility, indexing progress or the assistant using a different knowledge base. See [knowledge sources](https://help.complytrain.net/en/tenant-context/connect-knowledge-sources/) for the distinction between source configuration and indexed content.

## Pause or remove the connection

Product location: `/document-vault/vaults/{vaultId}/kb-links` (fallback: `/document-vault/vaults`)

Deactivate a link when its configured connection should be inactive. **Remove Link** unlinks the knowledge base from the vault; the confirmation says documents will no longer be indexed to that destination. It does not delete the vault or its documents. Check the knowledge base afterwards to confirm the vault's content has been removed from its index.
