---
title: "Step 2: Write your first page"
space: "Wiki"
url: "https://docs.frappe.io/wiki/quick-start/write-your-first-page"
updated: "2026-11-03"
---

In this step, Grace writes the page **How we deploy** in the Engineering Handbook. Her edits go into a change request, not to the live site.

## Create the page

A new space has no pages. The sidebar says **No pages yet**, and the page area has a **New page** button.

<picture>
  <source srcset="/files/gitimg-4fd128c937bc6c8540e491d12485734f9b6507ae.webp" media="(prefers-color-scheme: dark)">
  <img src="/files/gitimg-9869cd86a0c9a4ba2312bdb0babc9780592a17fe.webp" alt="The empty Engineering Handbook space, with No pages yet in the sidebar and a New page button in the page area">
</picture>

1. In the sidebar, click **Engineering Handbook** to open the space.
2. Click **New page**.
3. In **Title**, type `How we deploy`. The **Route** fills in as `engineering/how-we-deploy`.
4. Click **Save**.

<picture>
  <source srcset="/files/gitimg-6067caf6a36053f18adc343d8a1058e0691b3a56.webp" media="(prefers-color-scheme: dark)">
  <img src="/files/gitimg-bb46735f7cbfc282f71f454d0a6f78fef68a8368.webp" alt="The Create New Page dialog with the title How we deploy">
</picture>

The page opens in the editor.

In an empty space, Frappe Wiki starts a [change request](/wiki/change-requests/what-is-a-change-request) called **Add initial content** for you. In a space that has pages, you click **Edit** first. Then you give your change a title in the **New change request** dialog and click **Start editing**.

## Write the text

Click below the title and type. For example:

`We deploy from the main branch every weekday at 10:00 UTC. Each deploy goes to staging first.`

You can use Markdown shortcuts as you type. For example, `## ` starts a heading and `- ` starts a list.

## Add a callout

1. On a new line, type `/`.
2. Under **Callouts**, click **Warning**.
3. Type `Do not deploy on Fridays.`

## Add an image

1. On a new line, type `/` and click **Image**.
2. Select an image file on your computer, for example a diagram of the deploy pipeline.

The image uploads and shows in the page. You can also click **Insert Image** in the toolbar.

<picture>
  <source srcset="/files/gitimg-2e570fc4020c0f26984e94cb4e46d6bf4873dbd6.webp" media="(prefers-color-scheme: dark)">
  <img src="/files/gitimg-15caea8b15a56b50eb354cb3763a7ac5ae4c9a98.webp" alt="The page How we deploy in the editor with text, a warning callout and an image">
</picture>

## Your edits save as you type

You do not need a save button. When you stop typing for a moment, the editor saves your edits to the change request. **Saving…** shows at the bottom of the sidebar while it saves.

The card under the space name shows the title of the change request, its status **Draft**, and how many pages it changes.

<picture>
  <source srcset="/files/gitimg-447eed1319769310cf96ca05d576cc34d37ae7dd.webp" media="(prefers-color-scheme: dark)">
  <img src="/files/gitimg-990145302fa6c40b13a77388fc31179c2ce82e8b.webp" alt="The change request card in the sidebar with the title Add initial content, Draft and 1 page changed">
</picture>

Readers do not see the page yet. It goes live only after the change request is merged.

To learn more about the editor, see [Edit a page](/wiki/authoring-content/edit-a-page), [Callouts](/wiki/authoring-content/callouts) and [Images](/wiki/authoring-content/images).

## Next

[Step 3: Submit for review](/wiki/quick-start/submit-for-review)