Editing a Confluence page is straightforward: open the page, click the pencil icon or press E, make your changes in the editor, and hit Update or Publish.
Whether you’re fixing a single typo or overhauling an entire knowledge base article, the editing workflow is the same across Confluence editions. Once you know how to enter edit mode, use the editor toolbar, and save your changes, you can move through pages with confidence. The only real curveball is the layout difference between Atlassian’s Cloud and Data Center products, and the table below covers that completely.
Finding the Edit Button (and What to Do If It’s Missing)
The edit action lives on the live page view. In Confluence Cloud, the Edit icon — a small pencil — sits near the top right of the page. You can also press the E key to jump straight into the editor without using the mouse.
In Confluence Data Center and older Server versions, the Edit button is in the same general location inside the top toolbar. If the button is grayed out or missing entirely, your account has view-only permissions for that space. Contact your Confluence administrator to request edit access. Without the right permission level, the editor stays locked regardless of how you try to open it.
How to Edit a Confluence Page: The Step Order That Works
Once the editor opens, Confluence behaves like a standard web-based document editor. You click directly on the content to modify text, tables, images, and embedded links. The formatting toolbar at the top handles headings, lists, bold, italics, and more.
Follow this exact sequence to make sure nothing gets lost:
- Make your changes. Click anywhere in the page body to edit. Drag and drop content blocks to rearrange whole sections.
- Preview before publishing. In Confluence Data Center, the Preview button opens a read-only view of the page as it will look to readers. Cloud users can access preview through the editor’s overflow menu (the three dots) or the View tab toggle.
- Write a version comment. In the What did you change? field, add a brief note summarizing the edit. This populates the page history and helps collaborators track changes later.
- Click Update or Publish. In Cloud, the blue Update button sits in the top‑right corner. In Data Center, the button reads Publish. Either one saves the new version and returns the page to view mode.
That is the entire workflow. The bulk of confusion around Confluence editing comes from the slight differences between Cloud and Data Center, so the table below shows exactly what to look for in each environment.
Confluence Cloud vs. Data Center: Editing Differences
| Feature | Confluence Cloud | Confluence Data Center 10.2+ |
|---|---|---|
| Enter Edit Mode | Pencil icon or E key | Edit button or E key |
| Editor Toolbar | Top of the page editor | Top of the page editor |
| Preview Option | Overflow menu or View toggle | Preview button |
| Save Action | Update (top right) | Publish (top right) |
| Version Comment | Field below the editor | “What did you change?” field |
| Edit Permission Gate | Space or page view permissions | Space or page view permissions |
Editing Attached Files vs. Editing Page Content
A common mix-up happens when someone tries to replace an image or PDF by editing the page itself. Attached files live outside the page editor. To update an attachment, scroll to the attachments list at the bottom of the page, click the file name, and choose Edit.
In Confluence Data Center, editing an attachment launches the Atlassian Companion app, which opens the file in your default desktop application (Word, Photoshop, or whatever is installed for that file type). After you save the file locally, the Companion app uploads it to Confluence as a new version. Your browser must allow the Companion app to launch, or the upload step will fail. This is a completely separate workflow from editing the page body.
Version History: Your Safety Net
Every publish or update creates a permanent snapshot of the page. You can view this history by opening the page and selecting Page History (in Cloud, find it under the … menu). From the history screen you can compare any two versions side by side and revert the page if an edit goes wrong.
This versioning system makes it practically impossible to permanently destroy content. Combined with clear version comments, it gives every editor a full safety net and a complete audit trail of who changed what and when.
Common Editing Pitfalls and How to Fix Them
| Problem | Why It Happens | The Fix |
|---|---|---|
| Edit button is missing | Your account has view-only page permissions. | Contact your Confluence admin to request edit access for that space or page. |
| Changes disappeared after saving | Another user published an update while you were editing, causing a conflict. | Open Page History, find the version containing your changes, and restore it. Then re-merge the other edits manually. |
| Formatting looks broken on publish | Text was pasted directly from Microsoft Word or a rich web page. | Use the Paste as plain text option (press Ctrl+Shift+V) and reformat with Confluence’s native tools. |
| Cannot edit the page as HTML/CSS | Confluence Cloud does not allow direct source code editing. | Use Atlassian’s supported macros (HTML macro, CSS macro) or ask an admin about custom layout configurations. |
| Attachment edits won’t save back | The Atlassian Companion app is blocked by the browser. | Allow browser popups for Companion, or download the file manually, edit it locally, and upload it as a new version. |
Confluence Editing Checklist
Before you close the editor, run through this short list to make sure every edit is solid and nothing is missed:
- Did you make the intended change without introducing new errors?
- Did you preview the page to catch formatting inconsistencies?
- Did you write a descriptive version comment summarizing the update?
- Did you click Update (Cloud) or Publish (Data Center) to save?
Master these four steps and you’ll edit Confluence pages as efficiently as anyone on your team.
References & Sources
- Atlassian. “Formatting and Editing a Confluence Page” Official Atlassian guidance for Confluence Cloud editing workflow.