# Editor overview (/editor)
Related: [What is the agent?](/agent.md), [Assistant](/assistant.md), [Automations overview](/automations.md), [Mintlify CLI](/cli.md), [Components overview](/components.md), [Guides](/guides.md)
A step-by-step walkthrough: create a branch, make a change, share a preview, and publish.
## Open the editor [#open-the-editor]
Open the editor from the [Editor](https://app.mintlify.com/editor) tab in your Mintlify dashboard. Any member of your organization can open the editor, but what you can do inside depends on your [role](/dashboard/roles). Admins and editors can edit and publish, and viewers can browse content and leave [comments](/editor/comments) or [suggestions](/editor/suggestions).
## How the editor works [#how-the-editor-works]
**Changes save automatically.** As you type, the editor saves your work. Your changes persist across tabs, devices, and network interruptions. Changes only go live when you publish them.
**Git stays in sync.** When someone else pushes changes to your repository from outside the editor, those changes appear in the editor automatically. You don't need to pull or refresh. The editor merges non-conflicting changes and highlights anything that needs your attention.
If the editor ever appears out of sync with your repository, use [Reset editor](/editor/settings#reset-editor) to force a resync from Git. For example, the file tree is empty or shows `Unable to find docs.json` even though the file is present on your deployment branch.
**Publishing writes to Git.** When you publish, the editor commits your changes to your repository. On a deployment branch, this updates your live site immediately. On a feature branch, it creates a pull request.
**Your team edits together.** Multiple people can edit the same page simultaneously. Live cursors show who is editing and where.
## The editor layout [#the-editor-layout]
* **Top bar**: Use the top bar to control what branch you work on, access the agent, preview, and publish changes.
* **Navigation sidebar**: Select a page to edit, create new pages, and manage the site structure.
## Explore the editor [#explore-the-editor]
How branches and protection rules determine what happens when you publish, and how to manage the pull request review process.
Leave feedback, ask questions, and discuss changes with your team.
Propose changes that teammates can review, accept, or reject.
Edit pages, search your content, modify settings, and configure your site from a chat interface.
Add new and update existing pages.
Reorder pages and manage site structure.
Preview your site in real time as you edit without waiting for a build.
Configure your site's branding, colors, and features.
Configure AI instructions and publishing defaults for your deployment.
Understand the Git concepts behind the editor: branches, commits, pull requests, and merges.
Save time with keyboard shortcuts.