---
title: "What are instance tours in the knowledge base"
description: "Step-by-step UI guides your team creates on the instance and launches from knowledge base articles."
---

# What are instance tours?

**Instance tours** are interactive step-by-step guides in **Constructor**: the system highlights UI elements, shows hints, and walks the user through a route (for example, from the home screen to bot settings). Tour content is stored **on your instance**, not only in the general ConnectiveOne product release.

---

## Why it matters

- **Team onboarding** — a new colleague opens an article in the **knowledge base** and launches a tour for the right area.
- **Up-to-date internal processes** — when your organization changes a workflow, you update the tour without waiting for a platform release.
- **Text plus action** — a Markdown article can include a **Launch tour** card next to the written instructions.

---

## What this is not

| Easy to confuse with | Instance tours |
|----------------------|----------------|
| **AI Assistant** product tour catalog | Instance tours are **authored by your team** under **Instance tours** |
| Plain text in the **knowledge base** | A tour is a separate YAML definition; the article only **embeds** a launch link |
| A tour without access rights | Restricted tours show a no-access state on the card |

---

## Who can do what

- **Browse and launch** — users with access to **Knowledge base** who can read the tour (public or role-restricted).
- **Create, edit, import YAML** — users with **Manage instance UI tours** (Settings → Roles) or root; co-authors listed in the tour’s edit roles.
- **Insert a tour into a document** — while editing Markdown in **Knowledge base**, if the user can edit that document.

---

## Availability

**Instance tours** appear only when an administrator enabled **Instance Docs** under [Configure instance settings](../../settings/how-to/configure-instance.md) (same as **Knowledge Base**). If you do not see the menu items, contact your administrator.

---

## Related materials

- [Use instance tours](../how-to/use-instance-tours.md)
- [Use the instance knowledge base](../how-to/use-instance-knowledge-base.md)
- [What is the instance knowledge base](./what-is-instance-knowledge-base.md)
- [Constructor hub](../integrator-hub.md)