How to use the editor

A complete walkthrough of the editor workflow: create a branch, edit pages, preview your changes, and publish.

This tutorial walks you through a complete content update using the editor. You’ll create a branch, make a change, share a preview for review, and publish your changes.

1. Create a branch

   A branch is a temporary copy of your content. It’s where you make your changes without affecting your live site.

   Think of branches like drafts. You can merge them into your live site or safely discard them if you choose not to make the changes.

   Working on a branch keeps your edits separate from your live site until you’re ready to share the content with your users.

   1. In the editor toolbar, click the branch name (usually main).

      

   2. Click Create new branch.

   3. Enter a name that describes your change, like update-quickstart.

   4. Click Create branch.

   The editor switches to your new branch. Any changes you make are only on the branch. They only appear on your live site when you complete the publishing process.

2. Make your changes

   Edit an existing page or create a new one.

   To edit a page: Click it in the navigation sidebar to open it. Type directly in the editor to add content. Press / to insert components, images, or other content.

   To create a page: Click the plus button next to the navigation group where you want to add the page, then click Add a page and enter a filename.

   
3. Publish your branch

   To review your changes, you must create a pull request. A pull request is a proposal to merge your changes into the main branch that your site is built from.

   When you publish your branch, you make it available for review by your team. The changes only appear on your live site if you merge the pull request.

   1. Click Publish in the toolbar to open the publish menu.

      

   2. Optionally, click any changed file in the list to view and compare your edits against the published version.

   3. Click Save in branch to save all changes on your branch.

   4. Click Create pull request. Add a title and description, then click Publish pull request.

   5. Continue to GitHub to view your pull request and review your changes.

4. Review your changes

   Share your pull request with your team to review your changes.

5. Merge your pull request

   When your changes are approved, merge your pull request into the main branch. Your changes deploy to your live site.