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

# Navigation Panel

> Navigate your script using sections, notes, and scene headings in a hierarchical tree.

The Navigation panel provides a bird's-eye view of your script's structure, making it easy to jump between scenes and organize your screenplay.

## Open the Navigation Panel

<Steps>
  <Step title="Show Project Panel">
    Press `Cmd/Ctrl+J` to toggle the Project Panel on the left side
  </Step>

  <Step title="Select Navigation tab">
    Click the **Navigation** tab (globe icon) at the top of the Project Panel
  </Step>
</Steps>

## What Appears in Navigation

The Navigation tree shows:

**Sections** (`#` or `##` syntax):

* Acts, sequences, or custom organizational units
* Collapsible to show/hide their contents
* Example: `# ACT TWO` or `## Opening Sequence`

**Notes** (`[[note]]` syntax):

* Inline notes marked with double brackets
* Show their content in the tree
* Example: `[[TODO: Add foreshadowing here]]`

**Scene Headings**:

* All `INT.` and `EXT.` scene headings
* Displayed under their parent section (if any)
* Click to jump directly to that scene

<Tip>
  Use sections to organize your script into Acts, Sequences, or Story Beats. They're invisible in the final output but essential for navigation.
</Tip>

## Navigate Your Script

### Jump to a Scene or Section

Click any item in the Navigation tree to instantly jump to that location in your script. The editor scrolls and places your cursor at the selected item.

### Collapse/Expand Sections

Click the **arrow** next to a section to collapse or expand its contents:

* **Collapsed**: Hides all scenes and notes under that section
* **Expanded**: Shows the full hierarchy

This helps you focus on specific parts of your script without visual clutter.

## Organize with Sections

Sections create hierarchical structure in your script.

### Create a Section

<Steps>
  <Step title="Add section syntax">
    Type `#` followed by a space and your section name on its own line:

    ```
    # ACT ONE

    # ACT TWO - THE CONFRONTATION

    ## Sequence: The Heist
    ```
  </Step>

  <Step title="Sections appear in navigation">
    The Navigation panel updates automatically to show your new section
  </Step>

  <Step title="Write scenes under the section">
    Any scene headings after a section are nested under it in the navigation tree
  </Step>
</Steps>

### Section Levels

* **`#` (single hash)**: Top-level sections (Acts, Parts)
* **`##` (double hash)**: Sub-sections (Sequences, Beats)
* **`###` (triple hash)**: Further nesting (rarely needed)

**Example hierarchy**:

```
# ACT ONE

INT. COFFEE SHOP - DAY

## Inciting Incident

INT. ALICE'S APARTMENT - NIGHT

EXT. CITY STREET - DAY

# ACT TWO
```

**Navigation shows**:

* ACT ONE
  * INT. COFFEE SHOP - DAY
  * Inciting Incident
    * INT. ALICE'S APARTMENT - NIGHT
    * EXT. CITY STREET - DAY
* ACT TWO

[Learn more about sections →](/writing/formatting-basics#sections)

## Use Notes for Planning

Notes appear in the Navigation tree, helping you track TODOs and reminders.

### Create a Note

Type `[[` followed by your note text and close with `]]`:

```
[[TODO: This scene needs more tension]]

[[Remember to foreshadow the twist here]]

[[CUT? This feels redundant]]
```

Notes appear:

* In the Navigation tree under their parent section
* Inline in your script (visible only to you, not in exports)

<Note>
  Notes don't print by default. Toggle them off in the Print Dialog if you want to export a clean script.
</Note>

## Reorder Scenes

You can drag and drop items in the Navigation tree to reorganize your script.

<Steps>
  <Step title="Click and hold">
    Click on a scene heading or section in the Navigation tree
  </Step>

  <Step title="Drag to new position">
    Drag it above or below another item. A blue line shows where it will drop.
  </Step>

  <Step title="Release to reorder">
    Drop the item. Your script editor updates to reflect the new order.
  </Step>
</Steps>

<Warning>
  Dragging a section moves all its child scenes and notes with it. Be careful when reordering large sections.
</Warning>

## Common Use Cases

### Structure a Three-Act Screenplay

```
# ACT ONE

INT. COFFEE SHOP - DAY

INT. ALICE'S APARTMENT - NIGHT

# ACT TWO

## Confrontation

INT. BOB'S OFFICE - DAY

## Midpoint Twist

EXT. WAREHOUSE - NIGHT

# ACT THREE

INT. COFFEE SHOP - DAY (FINAL SCENE)
```

### Track TODOs and Revisions

```
# ACT ONE

[[TODO: Opening needs more action]]

INT. COFFEE SHOP - DAY

[[CUT? This dialogue feels slow]]
```

Navigate directly to notes from the Navigation panel to address them quickly.

### TV Episode Structure

```
# COLD OPEN

EXT. CITY STREET - NIGHT

# ACT ONE

INT. POLICE STATION - DAY

INT. INTERROGATION ROOM - DAY

# ACT TWO

## A-Story: The Investigation

INT. CRIME SCENE - DAY

## B-Story: Personal Drama

INT. DETECTIVE'S HOME - NIGHT

# ACT THREE

EXT. FINAL CONFRONTATION - NIGHT

# TAG

INT. COFFEE SHOP - DAY
```

## Keyboard Shortcuts

| Action                   | macOS      | Windows     |
| ------------------------ | ---------- | ----------- |
| Toggle Project Panel     | `Cmd+J`    | `Ctrl+J`    |
| Jump to next section     | `Cmd+Down` | `Ctrl+Down` |
| Jump to previous section | `Cmd+Up`   | `Ctrl+Up`   |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Do sections appear in my final script?">
    No. Sections are for organization only. They don't print or export to PDF unless you explicitly enable them in the Print Dialog (**Sections** toggle).
  </Accordion>

  <Accordion title="Can I nest scenes inside scenes?">
    No. Only sections can contain other items. Scenes are always leaf nodes in the hierarchy.
  </Accordion>

  <Accordion title="What happens if I delete a section?">
    Only the section marker is deleted. The scenes under it remain in your script but become top-level items in the Navigation tree.
  </Accordion>

  <Accordion title="Can I rename a section?">
    Yes. Just edit the section line in your script. The Navigation tree updates automatically.
  </Accordion>

  <Accordion title="Why doesn't my note appear in Navigation?">
    Make sure it's on its own line and properly formatted: `[[note text here]]`. Notes inline within action or dialogue may not appear in the tree.
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Formatting Basics" icon="book" href="/writing/formatting-basics">
    Learn how to use sections and notes syntax
  </Card>

  <Card title="Script Info" icon="info-circle" href="/project-panel/script-info">
    Set up your title page metadata
  </Card>

  <Card title="Characters" icon="users" href="/project-panel/characters">
    Manage character information and dialogue stats
  </Card>

  <Card title="Project Info" icon="lightbulb" href="/project-panel/project-info">
    Add logline and scratchpad notes
  </Card>
</CardGroup>
