---
title: Web Editor
description: Edit your Jamdesk docs in the browser — browse your connected repo, edit MDX with a live preview, and commit straight to GitHub, which triggers a build automatically.
---

> **For AI agents:** the complete documentation index is at [llms.txt](/docs/llms.txt). Append `.md` to any page URL for its markdown version.

The web editor lets you edit your documentation directly in the Jamdesk dashboard — no local setup, no terminal, no Git commands. Open a page, edit its MDX with a live preview beside you, and commit your changes to your GitHub branch. Every commit kicks off a build automatically, so your changes go live the same way a `git push` would.

It's the browser-based counterpart to [local preview](/development/local-preview) and the [VS Code extension](/development/vscode-extension) — reach for it when you want to make a quick edit from anywhere, or when you'd rather not clone the repo at all.

## Open the Editor

Click **Editor** in the dashboard sidebar. The editor opens on your project's connected repository and default branch.

<Note>
The editor requires a [connected GitHub repository](/setup/connecting-github) and a wide screen (desktop). On narrower windows it shows a "wider browser needed" notice, since the code and preview panes need room to sit side by side. It's available to every project owner and team member, on all plans.
</Note>

## The Interface

The editor has three panes:

| Pane | What it does |
|------|--------------|
| **Navigation** (left) | Your site's pages and groups, read from `docs.json`. Filter pages, open the **Configuration** (`docs.json`) editor, or **Add page**. |
| **Editor** (center) | An MDX code editor for the open file, with syntax highlighting and a word count. |
| **Preview** (right) | A live render of the page, updated as you type. Toggle **Desktop / Mobile** and **Light / Dark** to check how it looks. |

The branch you're editing is shown at the top left; switch branches with the branch picker.

## Edit a Page

Click any page in the navigation to open it. Edit the MDX in the center pane and watch the preview update live. Your edits are kept as a local draft in your browser until you commit — so you can move between pages without losing work, and nothing is written to GitHub until you choose to commit.

## Add a Page

Click **Add page** to create a new page without leaving the editor:

1. Pick a starter template.
2. Enter a title — the page's file name is derived from it automatically.
3. Choose which navigation group it belongs to.

The new page opens as a draft. When you commit, Jamdesk writes both the new `.mdx` file and the `docs.json` navigation entry in the same commit.

## Commit Changes

When you're ready to publish, commit your pending changes to GitHub:

<Steps>
  <Step title="Open the commit dialog">
    Click **Commit**. The dialog lists every file you've changed (a page, `docs.json`, or several at once).
  </Step>
  <Step title="Write a message">
    Type a commit message, or click **Generate** to have Jamdesk write one from your diff.
  </Step>
  <Step title="Commit">
    Jamdesk commits the changes to your current branch and immediately starts a build. Track it on the project's **Builds** page.
  </Step>
</Steps>

Prefer to throw the edits away instead? **Revert** discards the current page's unsaved changes and restores the committed version.

## Working With External Changes

If someone else pushes to the same branch while you're editing, the editor notices the branch moved and flags it. When you commit, any file that changed upstream is surfaced as a three-way merge so you can reconcile the two versions — your local edits are never discarded.

<Tip>
Committing from the editor is exactly like pushing from your own machine: it writes a real commit to your repo and triggers the same build pipeline. If your docs live in a subdirectory of the repo ([monorepo setup](/setup/monorepo-support)), the editor reads and writes there automatically.
</Tip>

## Requirements

| Requirement | Detail |
|-------------|--------|
| **GitHub connected** | The project must have a connected repository and branch. |
| **Desktop browser** | A wide screen (roughly 1400px+); the editor is not available on mobile widths. |
| **Access** | Any project owner or member. Editing writes to your repo, so the usual write locks (for example, a past-due subscription) apply. |

## What's Next?

<Columns cols={2}>
  <Card title="Local Preview" icon="eye" href="/development/local-preview">
    Preview and edit locally with the CLI
  </Card>
  <Card title="How Deployment Works" icon="rocket" href="/deploy/lifecycle">
    What happens after you commit
  </Card>
</Columns>