> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dovetail.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Workspace context docs

<Info>
  Available on the Enterprise plan.

  Only workspace admins can link and manage workspace context docs.
</Info>

## Overview

Workspace context docs let admins link existing Docs as persistent knowledge for Dovetail AI. Once linked, that content is injected into every Chat, Agent, and Ask Dovetail conversation across the workspace — so you don't have to explain who you are, what you build, or how your team talks about customers every time you ask a question.

If a linked doc is updated, the context refreshes automatically. There's nothing to re-link or re-save.

***

## How workspace context docs work

### Where they apply

Workspace context docs apply everywhere Dovetail AI shows up — Chat, Agents, and Ask Dovetail — for every user in the workspace. Applies to Slack and Teams too, if you've connected [Chat in Slack and Teams](https://docs.dovetail.com/help/chat/chat-in-slack-and-teams).

Access is still governed by permissions. See [Permissions and sharing](#permissions-and-sharing) below.

### How content is processed

* **Short docs** are used as-is.
* **Longer docs** are automatically summarized so they fit cleanly into the AI's context window without crowding out other context or degrading response quality.
* **Edits** to a linked doc are picked up automatically on the next interaction — you never need to re-link.

### How context docs fit with other context

Chat draws on more than just workspace context docs. Here's how the layers relate:

| Layer                      | What it is                                                                    | Who controls it  |
| :------------------------- | :---------------------------------------------------------------------------- | :--------------- |
| **Workspace context docs** | Persistent reference knowledge — strategy, glossary, brand voice              | Workspace admins |
| **Location context**       | What's pre-loaded based on where Chat is opened (project, channel, doc, etc.) | Automatic        |
| **Search results**         | Live evidence retrieved for each question                                     | Automatic        |

Context docs teach the AI *who you are*. Your projects and channels teach it *what customers said*. For the full breakdown of how all context layers combine, see [Chat: Technical overview](https://docs.dovetail.com/help/chat/technical-overview).

***

## What to include (and what to leave out)

**Good candidates for a context doc:**

* Company and product context
* Strategy and priorities — OKRs, focus areas, what's out of scope
* Customer and market context — ICP, segments, personas
* Product domain knowledge — features, workflows, known limitations
* Pricing and packaging
* Brand and tone guidelines
* Research frameworks and report templates
* Glossaries and preferred terminology

**Not a good fit:**

* Raw research data (interviews, transcripts, tickets) → belongs in a Project or Channel, not a context doc
* Findings from a specific study → use a Project Doc or that project's overview instead
* A one-off answer to a single question → just ask Chat at the right scope
* Highly sensitive content you don't want broadly accessible → see [Permissions and sharing](#permissions-and-sharing)

***

## Set up workspace context docs

1. Go to **Workspace settings → AI → Custom context**.
2. Search for and select existing Docs to link.
3. Save your selection.
4. Confirm sharing — linked docs need to be shared with the workspace at **Can view** access or higher (see [Permissions and sharing](#permissions-and-sharing)).
5. Test it — open Chat at the workspace level and ask something that depends on background knowledge, like *"What's our ICP?"* or *"How should I refer to our product tiers?"*

<Tip>
  Start with 3–5 focused docs rather than one long reference file. Focused docs are easier to keep up to date, and summarize more accurately when they're long.
</Tip>

***

## Best practices for writing context docs

**Keep each doc focused.** One purpose per doc. Link several focused docs instead of a single catch-all.

**Use clear structure.** Headings, bullet points, and labeled sections help the AI parse a doc correctly — especially once it gets summarized.

**Be explicit.** Spell out preferred terminology (*"customers,"* not *"users"*), product and plan names, what's in scope vs. out of scope, and any compliance or privacy rules.

**Separate facts from behavior.** Company info, product specs, and glossaries are facts — they belong in a context doc. Tone, formatting, and citation preferences are behavior — they're often better set through your workspace's [custom instructions](https://docs.dovetail.com/help/chat/technical-overview#1-workspace-level-custom-instructions), with a context doc as backup for anything that needs more detail.

**Keep docs maintained.** Treat context docs as living reference material. Outdated strategy or product info leads directly to outdated AI answers.

**Don't duplicate project-level content.** Project-specific research context belongs in [project overviews](https://docs.dovetail.com/help/chat/prompt-guidance/Prompt-guidance#crafting-your-project-overview) and project Docs, not workspace context docs.

***

## Permissions and sharing

Linked docs don't have to be shared workspace-wide. Chat still respects every existing Dovetail permission — the AI can't surface content a user can't already see.

* If a linked doc has restricted permissions, only users with at least **Can view** access to that doc will have it applied to their chat context.
* For the context to benefit the whole workspace, share each linked doc with the entire workspace at **Can view** access or higher.

For more on access levels, see [Access and permissions](https://docs.dovetail.com/help/access-and-permissions).

***

## Starter pack: docs to link

A focused starting set covers most workspaces well. Create each as its own Doc, fill in the details, and link all five in **Workspace settings → AI → Custom context**.

### 1. Company & product overview

Give the AI foundational knowledge about who you are and what you build.

```markdown theme={null}
# Company & product overview

## About [Company name]
[2–3 sentences: what your company does, who you serve, your market position.]

**Founded:** [Year]
**Headquarters:** [Location]
**Industry:** [Industry/vertical]

## What we build
**Product name:** [Product name]
**One-line description:** [Single sentence]

**Core value proposition:**
- [Benefit 1]
- [Benefit 2]

## Key product areas
| Area | Description |
|------|-------------|
| [Area 1] | [What it does] |

## What we are NOT
- [Explicit boundary, e.g. "We are not a CRM"]
```

### 2. Terminology & glossary

Keep language consistent across every AI-generated response.

```markdown theme={null}
# Terminology & glossary

## Preferred terms
| Use this | Not this | Notes |
|----------|----------|-------|
| customers | users | We serve B2B buyers, not end-users |
| workspace | account | Our product term for a team environment |

## Product & plan names
| Name | Description |
|------|-------------|
| [Plan: Free] | [What's included] |
| [Plan: Pro] | [What's included] |

## Internal acronyms
| Acronym | Meaning |
|---------|---------|
| ICP | Ideal Customer Profile |
| VoC | Voice of Customer |
```

### 3. Brand voice & AI response guidelines

Shape how the AI communicates — tone, format, and behavioral rules.

<Tip>
  If your workspace already sets tone and formatting through [custom instructions](https://docs.dovetail.com/help/chat/technical-overview#1-workspace-level-custom-instructions), you may not need this as a separate doc. Use whichever is easier for your team to maintain.
</Tip>

```markdown theme={null}
# Brand voice & AI response guidelines

## Tone & voice
- **Formality:** [Professional but approachable / Formal / Casual]
- **Perspective:** [First person plural ("we") / Third person]

## Content rules
### Always
- Cite sources from Dovetail data when making claims
- Anonymize customer names unless viewing a specific data entry
- Use our preferred terminology (see Terminology & glossary doc)

### Never
- Mention specific competitor products by name in outputs
- Make up data or quotes not found in the workspace
```

### 4. Customer & market context

Help the AI understand who your customers are and how you talk about them.

```markdown theme={null}
# Customer & market context

## Ideal Customer Profile (ICP)
**Primary ICP:** [Description]
**Company size:** [Range]
**Buyer persona:** [Title/role]

## Customer segments
| Segment | Description | Key needs |
|---------|-------------|-----------|
| [Segment 1] | [Who they are] | [What they care about] |

## How we talk about customers
- Refer to them as "[customers]" — not "[avoided term]"
- Our customers typically struggle with [pain point 1] and [pain point 2]
```

### 5. Research & reporting standards

Keep AI-generated Docs and summaries aligned with your team's methodology.

```markdown theme={null}
# Research & reporting standards

## Report structure
1. **Executive summary** — key takeaway first
2. **Key findings** — organized by theme, with supporting quotes
3. **Recommendations** — actionable next steps

## Citation standards
- Attribute quotes to segment/role, not individual names (e.g. "Enterprise PM," not "Jane")
- Link back to source data in Dovetail when possible
```

<Tip>
  **Quick-start checklist:** fill in the placeholders above, share each doc with the workspace at **Can view** access or higher, link all five in **Workspace settings → AI → Custom context**, then test with a few questions from your starter set. Assign an owner to review and update the docs quarterly.
</Tip>

***

## Test your setup

Once your docs are linked, try a few questions that only a well-informed teammate could answer well:

| Test question                                      | What a good answer should reflect               |
| :------------------------------------------------- | :---------------------------------------------- |
| "Who is our target customer?"                      | ICP and segments from your customer context doc |
| "How should I refer to our product tiers?"         | Plan names from your pricing/packaging doc      |
| "What tone should I use when drafting a summary?"  | Your brand voice guidelines                     |
| "What's in scope for this quarter's product work?" | Your strategy/priorities doc                    |
| "How should I structure a research report?"        | Your research standards doc                     |

***

## FAQs

<AccordionGroup>
  <Accordion title="How many docs can I link?">
    \[Confirm current limit before publishing.]
  </Accordion>

  <Accordion title="Do context docs replace search?">
    No. Context docs provide background knowledge about your company and product. Chat still searches your workspace data for every question and cites its sources — context docs just make those answers better informed.
  </Accordion>

  <Accordion title="What happens if I unlink a doc?">
    Its content is removed from the AI's context on the next interaction.
  </Accordion>

  <Accordion title="What's the difference between workspace context docs and a project overview?">
    Workspace context docs carry company-wide reference knowledge that applies everywhere in Dovetail AI. A [project overview](https://docs.dovetail.com/help/chat/prompt-guidance/Prompt-guidance#crafting-your-project-overview) carries context specific to a single project.
  </Accordion>
</AccordionGroup>

***

Related articles

* [**Chat: Technical overview**](https://docs.dovetail.com/help/chat/technical-overview)
* [**Prompt guidance**](https://docs.dovetail.com/help/chat/prompt-guidance/Prompt-guidance)
* [**Access and permissions**](https://docs.dovetail.com/help/access-and-permissions)