Create, edit, and publish
You can create a page from anywhere in Confluence—just hit and you're ready to go. in the sidebar
- Parent page: Your new page will be a child of the page you were on when you hit .
- Space: If you hit personal space. from outside of a space, you'll need to select a space for your page to live in, and your page will be created under that space's overview. The default option will be your
- Page templates: Choose what kind of page template you'd like to start with. Confluence comes with prepackaged templates, which you can alter to suit your needs on both a site-wide and space-wide basis. Any other templates you create will also appear here. Blog posts are slightly different in that they're not a template. They function just like pages, but instead of living in the page tree, they live in the blog roll where they're organised chronologically, and are ideal for sharing news and updates.
Once you decide on a blank page or template, you can start adding content to your page.
Can't create a page or blog?
To create a page or blog post, you need the Add Blog or Add page permissions for that space.
You and up to 11 teammates can edit a page together in real time in Confluence. Changes save and sync automatically, so that everyone editing sees the same thing.
- Invite to edit: Click on the plus sign to invite others to edit your page with you from inside the editor. Either copy and send them the page link, or send them a Confluence notification which will reach them via email and workbox.
- Avatars: People who are currently editing have colored avatars, while people who've made edits and left the page appear in greyscale.
If you've started scribbling and you're not quite sure if you're going to do anything with it, you can just close the editor without publishing. Confluence autosaves as you go, so this creates a draft – an unpublished page or blog post that you can get back to at any time by heading to Your work > Drafts from your sidebar.
We recommend only keeping your work as a draft when it's in a very early stage. This is because changes can't be tracked in a draft, and you can't roll back to previous editing sessions - both of which you can do for published pages.
Instead, it's recommended you publish your page even while it's in mid-work, and do one of the following:
- Use a status macro to mark your page work-in-progress: You can also change this to say under review, done, needs revising, looking for feedback, or any other step of your workflow.
- Move your pages as you work: If you've got an external facing site, or if your team is writing something like policies for the rest of your organisation, you can work on them in your team space, and then move them to an external facing space once they're done. Alternatively, you can work on something in your personal space, and then once it's been polished, move it to the official space that it needs to be under.
- Lock down pages until ready: Working on something that you don't want everyone to know about until it's ready? Lock down your page while you work on it, and only change the page restrictions once it's ready to go public.
Drafts and privacy
Drafts don't have an actual location and don't show up in searches, so they start off invisible to anyone except the person who created them. If that person then shares the draft URL or invites others to edit that draft with them, those people will also be able to see and edit the draft.
Delete a draft
To delete a draft, hit thewhile editing, and choose Delete unpublished page. Deleting a draft is permanent and can't be undone.
- Delete unpublished page: Permanently deletes your draft.
- Close: Closes the editor, saving your draft.
Naming content in Confluence
To help your users find what they're looking for, give your pages, blogs, and attachments relevant, easy to search for names. Here are a few other things you should also keep in mind:
- We recommend not using special characters in names, as they may not be found using Confluence search and can cause some Confluence functions to behave unexpectedly.
Unnamed drafts get called Untitled. Make sure you give pages a working name so you can tell your drafts apart.
As you edit, you can choose> Preview for a peek at what your finished page will look like.
Publishing in Confluence is like saving a document in your word processor. Unlike a word processor, though, Confluence creates a new version of your work each time you edit and publish. This means that you can go back and see your page history, and, if necessary, revert back to a previous version of your work.
Publishing closes the editor and takes you back to viewing the page. Once a page is published, you can find it in the page tree, under the parent page from which it was created. If you publish a blog post, it will live in the blog, which is organized chronologically. It's easy to move and reorganize pages, so you don't have to worry if you've published to the wrong place.
Each time you publish a page, add a comment about what you changed so it's easier to keep track of how a document is progressing . Change comments can be found in the page history.
Screenshot: the change comments box is located next to the Notify watchers option.
To notify people watching the page, from the ellipsis menu, select Notify watchers. Any change comments you added are included in the notification email. The Notify watchers checkbox remembers your last selection for each page, so if you choose not to notify people, the checkbox will be deselected for you next time you edit that page.
Editing and unpublished changes
If you want to edit a published page, you can hit edit, or just type E to open the editor. As with a draft, autosave will retain these changes, and you can get back to them by editing the page again.
Anyone else who edits this page will also see your unpublished changes. If you're concerned about this, add editing restrictions to the page until you're ready to publish those changes.
While a page has unpublished edits on it, Confluence will display an unpublished changes badge next to the page title, to remind you to publish. This only shows to people who've made unpublished changes, so you needn't worry about the badge distracting your viewers.
We recommend publishing frequently, as each time you publish, Confluence creates a new version of your page or blog, which not only means that it's easier to track changes over time, but it's also easy to revert back to a previous version if you ever need.
View unpublished changes
Want to know what's changed since a page was last published? Choose> View changes.
Delete unpublished changes
If you're working on a page with unpublished changes, and decide you no longer need them, you can discard them by choosing> Revert to last published version.
This will immediately delete those changes and restore the last published version. Those changes, as they were never published, are gone for good and can't be recovered.
Screenshot: Know exactly what you're deleting when you revert to the last published version.
Page versions and history
Version control is useful when you've got numerous people working on the same page. You can see how the page has changed over time, with each successive publish. You can also revert back to an old version if you decide you don't like some of the recent changes.
Screenshot: Navigate to the Page History while viewing a page
Delete a version of a page:
- Go to the page and choose > Page History
- Choose Delete next to the version you want to delete
Once you've deleted a version, the other versions will be re-numbered. For example, if you delete version 2, version 3 becomes the new version 2.
Deleting a page version is permanent. It won't be moved to the trash, so you can't restore a deleted version.
Restore a version of a page
- Go to the page and choose > Page History
- Choose Restore this version beside the version you want to restore (or at the top of the page if you've opened the version)
- Change the default change comment if necessary, and choose OK
All page history is retained, so if you decide to restore an old version, it won't delete any of the versions that came after it. Instead, Confluence creates a copy of that old version as the latest version.
Compare two versions
Want to see what's changed between versions? Use the comparison view to help you figure it out.
- Go to the page and choose > Page History
- Choose the versions you want to compare by selecting the check boxes beside them
- Choose Compare selected versions
You'll see the page comparison view showing the differences between the selected versions. To make the changes more distinguishable, all large sections of unchanged text are hidden and reduced to an ellipsis (. . .).
Screenshot: Comparing two versions of a page