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

# Documentation Modes

> Learn more about differences in documentation mode

## Overview

This guide explains the differences between documentation modes. A documentation mode is the combination of the approach and system prompt that governs how the task of document generation is carried out by the LLM.

Documents can be generated utilizing two different modes:

1. Global Sequential: the current default if nothing specified
2. Routed Parallel: the new, improved documentation generation mode

**All you need to do to generate a document with the new mode, is to set `documentationMode: routed_parallel` in your POST /documents request and reference a [supported template or supported sections](#template-and-section-requirements).**

<Tip>
  See the API specification for the [documentationMode property here](/api-reference/documents/generate-document#body-one-of-0-documentation-mode).
</Tip>

<Note>Routed Parallel currently only supports facts as input context.</Note>

| Context Type |      global\_sequential      | routed\_parallel                                                        |
| ------------ | :--------------------------: | ----------------------------------------------------------------------- |
| facts        | <Icon icon="circle-check" /> | <Icon icon="circle-check" />                                            |
| transcript   | <Icon icon="circle-check" /> | In closed Beta                                                          |
| string       | <Icon icon="circle-check" /> | 2026 H1 Roadmap for bigger improvements to summarize existing documents |

<Note>This feature requires human oversight of its outputs</Note>

<Card title="Advantages of routed_parallel" icon="badge-check">
  <Icon icon="check" /> **Faster document generation** <br />Increases in document generation up to 35% <sup>1</sup>

  <Icon icon="check" /> **Increased completeness** <br />Especially for use cases that involve a very high amount of facts, this method ensures the section generation step receives all relevant facts as input. Then the section-specific instructions govern the level of details, condensing or omissions for the synthesizing summary.

  <Icon icon="check" /> **More robust** <br />Variability of outputs, and content misplacement in irrelevant sections is significantly reduced.

  <Note><Icon icon="forward" /> This method might slightly increase input token consumption. In most production cases this will have a very slim effect on credit consumption, as input tokens to a large degree will be cached and are discounted. We will bring increased transparency and more detailed metadata related to document generation requests in the coming months.</Note>

  **Notes:**<br />
  <sup>1</sup> Depending on input size and complexity of section instructions.
</Card>

## How it works

To better understand the differences, let's have a look what's happening under the hood and the differences between the documentation modes.

### Routed Parallel

When specifying `documentationMode: routed_parallel` in the request with facts as input, this is what the Corti API and LLM do behind the scenes:

<Steps titleSize="h4">
  <Step title="Classification and routing">
    Based on each template section's `content` or `contentOverride` instructions, the LLM batch-assigns each fact to the relevant section(s).
    <Note>If the `content` or `contentOverride` field for a section is empty, the API will fail the request. Utilize the [GET template](/api-reference/templates/get-template) or [GET templateSections](/api-reference/templates/list-template-sections) endpoints to verify this field is populated, and ensure in case you use `contentOverride` this is not setting it as empty.</Note>
  </Step>

  <Step title="Parallel section generation">
    Now each section has only the relevant facts as input and all sections are generated in parallel based on each individual section's instructions, plus potential template-level global instructions.
  </Step>

  <Step title="Guardrails">
    Unless disabled in the request, documentation guardrails verify in parallel each section and, where relevant, replace indexed content segments with its corrected content.
  </Step>
</Steps>

### Global Sequential

When specifying `documentationMode: global_sequential`, this is what the Corti API and LLM do behind the scenes:

<Steps titleSize="h4">
  <Step title="Global context">
    The API passes the entire context from the request (all facts, full transcript, string) to the LLM.
  </Step>

  <Step title="Sequential section generation">
    Each section is generated sequentially processing the relevant aspects of the globally available context.
  </Step>

  <Step title="Guardrails">
    Unless disabled in the request, documentation guardrails verify in parallel each section and, where relevant, replace indexed content segments with its corrected content.
  </Step>
</Steps>

### Visual flow comparison

<CardGroup cols={1}>
  <Card>
    <img className="block dark:hidden" src="https://mintcdn.com/corti/Bf-ANk7PbOgKQGa9/images/documentation_modes_light.png?fit=max&auto=format&n=Bf-ANk7PbOgKQGa9&q=85&s=16f245f153b8690dade10a20bc763363" alt="Documentation Modes" width="3840" height="2160" data-path="images/documentation_modes_light.png" />

    <img className="hidden dark:block" src="https://mintcdn.com/corti/Bf-ANk7PbOgKQGa9/images/documentation_modes_dark.png?fit=max&auto=format&n=Bf-ANk7PbOgKQGa9&q=85&s=a6e36e63ea52f3defba789471fda8683" alt="Documentation Modes" width="3840" height="2160" data-path="images/documentation_modes_dark.png" />
  </Card>
</CardGroup>

## Template and section requirements

<Note>`documentationMode: routed_parallel` requires the `content` field on each section used in a template to be set. The API will return an error if this is not the case.</Note>

For clarity and backwards-compatibility, please check via [GET /template(s)](/api-reference/templates/get-template#response-documentation-mode) and [GET /templateSections](/api-reference/templates/list-template-sections#response-data-items-documentation-mode) the response property `documentationMode`.

<Tip>
  `global_sequential` templates and sections are only configured for `global_sequential`.
  `routed_parallel` templates and sections are optimized towards this documentation mode but can also be used with the `global_sequential` documentationMode.
</Tip>
