Documentation for Confluence 5.4.
Documentation for Confluence OnDemand and earlier versions of Confluence is available too.

Skip to end of metadata
Go to start of metadata

The Confluence editor is the tool that you will use to create and edit Confluence pages, blog posts and comments. You can enter content as you would in a Word document, apply formatting, and embed other content and files into the page.

Looking for a quick start? See the Quick Reference Guide for the Confluence Editor.

To begin an editing session, choose Edit at the top of a page (or press E on the keyboard).

A note about permissions: To edit a page, you need the 'Add Pages' permission for the space. See space permissions. Someone may also apply page restrictions that may prevent you from editing the page.

An editing session

You start an editing session whenever you:

While in an editing session, you can also:

  • Name, or rename, a page or blog post. Note that renaming has effects that you should consider.
  • Add a comment describing the changes you made.
  • Choose whether or not people watching the page get notified of the change you made.
  • Add labels to the page.

Confluence automatically saves drafts of your page as you work. If another user begins editing the same page as you, Confluence will display a message, and will try to merge the changes when you save your page.

Choose Cancel (at the bottom of the page) if you want to end the session without saving any changes.

The session ends when you choose Save.

When you create a new page you can choose the location where the page should be saved. You can also move a page after it has been saved, to make it a child page of a different page, or to move it to another space.

To see changes between different versions of the page, look at the history of the page.

The editor 

Screenshot: The Confluence editor


 

Item

Explanation

Page title

Type the name of the page. This name is used in links to the page.

Page content

Add the words, images and other content that forms the content of the page.

Editor toolbar

Use these tools to format and colour content, create lists and tables, indent and align text, and insert other content into the page, such as symbols, links, images, multimedia files and macros. The toolbar also provides the find and replace option, help, and full-screen editing options.

Restrictions

Control who can view or edit the page. See Page Restrictions.

Attachments

View, and manage, the attached files on the page.

Labels

Add labels to a page, to categorise the page content.

Change comment

Type a comment that describes the changes you have made.

Notify watchers

Select this option to prompt Confluence to send an email notification of your changes to people who are watching the page.

Preview

See how your changes will appear, without saving the page.

Save

Save the changes you have made to the page. (Keyboard shortcut: Ctrl+S).

Cancel

End the editing session, without saving any changes.

Toolbars

From the toolbar you can: 

  • Apply paragraph styles and character formatting (such as bold, italics, superscript).
  • Choose colour for text.
  • Create numbered and bulleted lists.
  • Set the indenting and alignment for text and images.
  • Create links to other pages, attachments, anchors and external resources.
  • Add tables, and add, remove, cut and paste rows and columns, highlight cells, rows and columns, and merge and split cells.
  • Insert other content into the page, such as images, multimedia, attachments, symbols and markup.
  • Use macros to add other types of content, such as a list of JIRA issues or a table of contents.
  • Add layouts and columns and sections to your page.
  • Find and replace content within the page that you are editing.
  • Hide the tools at the top and bottom of the page, giving you a much larger editing area (a full-screen editor).
    Note: The full-screen editing option is available in Firefox, Chrome and Safari. It is not supported in Internet Explorer. The editor remembers your full-screen preference the next time you edit a page.

Screenshot: The editor toolbar


Embedding content in the page

Choose Insert on the editor toolbar to include any of the following types of content on your page:

Things to help you work faster

Autoformatting

You can type Confluence wiki markup directly into the editor to have Confluence auto-format your text as you type. To learn more, choose ? on the editor toolbar and choose the Editor Autoformatting tab. See also See the Quick Reference Guide for the Confluence Editor.

Autocomplete

When editing a page or blog post, you can enter a trigger character to show a list of suggested links, media files or macros to add to your page. This feature is called 'autocomplete' and provides you with a fast editing solution if you prefer to use key strokes rather than pointing and clicking with the mouse.

Quick summary of autocomplete:

Type:

To see suggested:

[

pages and blog posts

!

multimedia files

{

macros

@mentions

For details, see Using Autocomplete.

When you paste URLs into Confluence, the editor will analyse what you are pasting and automatically convert it into something that will display well in Confluence. Examples include:

  • YouTube videos
  • JIRA issue queries
  • Google Maps
  • Confluence pages, blog posts, comments, user statuses, user profiles.
  • Shared screenshot links from Skitch
  • And more.

Drag-and-drop for external images and files

You can drag a file from a location outside Confluence, and drop it directly into the editor. For example, try it with images, video files, audio files, Office documents, and PDF files. The contents of the file will be embedded into the page or blog post. Please refer to the following pages for more information:

Drag-and-drop within the editor

Working within the editor panel, you can drag an image or a macro from one location on the page and drop it into a different location on the page. Hover your cursor over the image or the macro placeholder. The cursor changes to a drag-and-drop icon  and you can click the image or macro and drag it to a new location.

If you want to abandon the drag-and-drop action, press Escape. The image/macro will return to its original position.

Note: For the drag-and-drop of images and macros in the editor, Confluence supports the following browsers: Chrome, Firefox, and Internet Explorer 9. (Drag and drop in the editor does not work in Internet Explorer 8.)

Keyboard shortcuts

To see the keyboard shortcuts available, choose ? on the editor toolbar.

Finding and replacing text

Click the find / replace icon on the toolbar, or use the keyboard shortcut Ctrl+F (Windows) or Cmd+F (Mac OS).

Search matches are highlighted in yellow. You can step through the results one by one, replace the matching text strings one by one, or replace all matching strings at once. This find and replace feature works only within the current page.

Enabling and disabling autocomplete and autoformatting

You can enable or disable the editor's autocomplete and autoformatting functions, by editing the settings in your user profile.

In summary:

  1. Choose your profile picture at top right of the screen, then choose Settings.
  2. Choose Editor under 'Your Settings' in the left-hand panel.

For more details, see Editing User Settings.

39 Comments

  1. Guys:

    How do you either paste an Excel or Google Spreadsheet range into a wiki page?  This would seem to be base functionality.  Using | doesn't work either (unless I was willing to type it all by hand).  OR, there is not a commant that'll take text and format as table (based on tabs, for instance).

    -Bill

  2. Anonymous

    Is there a way to not start "find an replace" when I press Ctrl+F (Windows) or Cmd+F (Mac OS)? I'd like to use my browsers feature to find the word I'm looking for. Chrome for example immediately jumps to the first find spot with the word I'm searching while I'm still typing. This is much faster than the finding-feature offered by the confluence-editor. I'd like to use both: the fast way for just "finding" using my browser when I press Ctrl + F and the comfortabel "find and replace" using the editor, for example by pressing the find button on the toolbar. But I don't want confluence to override Ctrl+F which is my browser's find shortcut. Is there a way for doing this?

    1. Hallo there Anonymous

      As far as I know, there's no way to disable those short cuts. (See this doc, which states that you can't disable editor shortcuts.)

      However, what I do is to click down at the bottom of the page, outside the editor panel, to change the browser focus. Then the usual browser shortcut keys work, instead of the editor keys. A nuisance, but better than nothing. (smile)

      I hope this helps!

      Cheers, Sarah

  3. Anonymous

    I used to be able to cut and paste wiki markup from one confluence space to another - and did it all the time. Now it looks like I can't do that anymore, cause I can't figure out how to even see the underlying markup.

    1. Hallo there

      You're right – it's difficult to copy and paste the underlying markup. This page may help: Confluence Storage Format – it describes the options open to you.

      I hope this helps!

      Cheers, Sarah

  4. Hi everyone

    Is there any way to extend the number of named styles? Eg if we use a custom CSS, can we define classes (or something ... I'm not our CSS programmer!) and have them appear in the styles dropdown? If we're going to use Confluence, we need more named styles and non-programmers need to be able to use them.

    Thanks!

  5. Hi, 

    We've just moved to Confluence 5 and we're having alignment trouble in the editor. The formatting options aren't in alignment, and neither are the Preview and Save buttons.

    Any idea on how to fix this? I've tried zooming in and out, which has no effect.

    Screenshot here.

    Thanks,

    Beth

    1. Hallo Beth

      That's interesting! I'll ask one of the Confluence product managers to take a look, in case they've seen something similar. Stay tuned. (smile)

      Cheers, Sarah

    2. Hey Beth, strange one as the Header is also messed up. Seems like some CSS resources aren't being loaded but I'm not sure why that would be the case. 

      If it always happens could be a stale cache issue, doing a forced refresh with shift-f5 (or cmd-shift-r) might help.

      If it doesn't, it will be fastest to raise a case with http://support.atlassian.com and let them know what browser you're using, whether you have any custom themes or CSS, and whether you see this anywhere else outside of the editor and how repeatable it is (eg: always happens, sometimes happens).

      1. Hi John,

        No luck with the forced refresh or removing the CSS, I'm afraid. I've raised it with support - thanks for your help, and for getting back to me so quickly!

        Beth

        1. Hi Beth Aitman,

          Any news about the alignment issue ?

          I'm evaluating confluence 5.1.2 and I'm facing the same issue as you.

           

          Regards

          1. Hi Sebastien,

            For us, it turned out to be the custom CSS and HTML that we'd put in place on confluence 4. There was some CSS in another location that I wasn't aware of when I wrote the comments above! Removing a whole load of that sorted the problem out for us.

            Have you customised the look and feel of your confluence instance? Does it sound like it might be the same problem?

            Best,

            Beth

            1. Hi Beth,

              We don't have any CSS and HTML customisation...

              hmm very strange, I'll open a ticket to the support, because I really don't understand...

              Anyway, thanks for your feedback.

              Best Regards

              Seb

  6. Anonymous

    Hi guys, I'm new to Confluence so I may have missed it, but is there a way to save your updates in the editor without closing the page? If not, it would be great to see a "Save without Closing" button added to the text editor. As a technical writer I make a lot of changes and save them often during the editing of a single page so this would be a great good feature to have. Let me know if there's currently a way to do this. thanks!

    1. Hallo Anonymous

      The Confluence UI doesn't offer an explicit way to save drafts. Confluence does auto-save drafts at regular intervals as you work. Hint: To force the saving of a draft, preview the page.

      Here's the documentation on drafts: Working with Drafts

      I hope this helps!

      Cheers, Sarah

  7. Thanks for the tip Sarah.  I'd like to +1 a way of more easily saving work in progress.  A 'save draft' button from the UI would be a great addition, or a 'Save and Close'.  Its quite easy currently to inadvertently lose work.  I've hit Cancel after a Draft has been saved assuming that would just close the editor - it did but also deleted my draft! (sad) 

    Cheers

    Janson

  8. Anonymous

    How do you make headers in tables sortable? I see it work in the demonstration space, but I cannot find the option in the editor. The page Working with tables says it's possible but does not show how to do it?

    I marked the header with the Heading row and even set the text to header (see example below) but no sort option

    Taskstatus
    ContentDone
    ContentIn Progress
    DesignIn Progress
    ContentIn Progress
    DesignDone
    1. Do you mean making them sortable inside of the editor? Currently you can't sort them in the editor, only on the view page.

      Or do you mean that you can't sort them even in view mode (I can sort the one in your comment right now as an example). 

      1. Anonymous

        Would love to be able to sort in editor mode and have the resulting order saved on submit.  Just think, if you have an alphabetical list in a table you presently have to create it in alphabetical order and manually add rows above and below to maintain it.  Otherwise you have to hope people are smart enough to sort alphabetically (or by whatever value) each time they view the page.  Thanks.  penland at paynearme dot com

        1. Thanks, I've raised a request for this here:  CONF-28787 - Add the ability to sort table contents inside the editor Open

  9. Anonymous

    Hi,

    Is there a way to search and replace whitespace. After migrating to Confluence 4, we have loads of white space between numbered lists.

    Thanks

  10. Anonymous

    Hello there,

    where can I edit existing Balsamiq Mockups? I can't find it anymore on Confluence 5.1...

    Thanks & Cheers

  11. Finding and replacing text

    How can I replace normal text to emoticon?

    For example, I want to replace OK with (tick).

    But result is just

    (/)

     

  12. I'm having an issue where Confluence displays a small vertical scroll-bar on the top 3 inches of the blank space.  I cannot add or edit anything below the scroll-bar, even though the page is blank.  Is there a setting that I incidentally changed?  

     

    (updated) - this only occurs in Chrome.  

     

     

    1. This is a problem introduced by the latest version of Chrome.

      For more details, and a workaround, see this ticket: CONF-28415 - Editor is not full height Resolved

  13. Anonymous

    I am curious to know if you developed this editor from scratch or is it a third-party editor that was then customized?

    1. Hallo there Anonymous

      The Confluence editor is based on TinyMCE.

      Cheers, Sarah

      1. Hi Sarah, 

        I guess we should submit bugs/suggestions regarding the editor directly to you anyway, shouldn't we. So you yourselves can identify whether it's an issue in your customization or the original editor.

        Cheers, James

        1. Hi Jakub, you are welcome to submit editor suggestions and bugs here http://jira.atlassian.com/browse/CONF. You might want to have a search to see if there is an existing issue you can watch. 

          Rachel 

  14. Hello. How can I extend the editor with some jquery? I want to add my own web-item in the editor (is it possible?) and execute some javascript on the editor elements when it is clicked.

    Thanks in advance

  15. Hi, 

    We are currently planning an upgrade of our 3.5.16 version of Confluence to the latest one (5.2). Should we anticipate any improvements in editor in terms of table  column resizing?  I understand this issue was under discussion from 2009, but cannot find any references to the documentation, where improvement actually have been stated.
    Number of users currently using our system experiencing difficulties in  resizing columns of already created tables and our only advice for now is to recreate the table from scratch with desired size. Will be great to believe that with new version (5.2), this issue will be fixed. 

     

    1. Table columns resize based on the amount of content in each cell. There is no Confluence editor button or control to set a specific or fixed column width.  

      1. Is this something that is going to be improved? Also, is there any plug-ins you can recommend to integrate with Confluence to work the issue out?

        1. You might want to ask your question over at Answers. I'm sure there will be users from the community who have suggestions and recommendations for plugins. 

  16. the feature is fatastic , but I have a question that the new confluence can't layout the level 

    in the old version when you choose  head2 layout html code is like this 

    <h2></h2>

    <hr>

    but when update the new version,it became

    <h2></h2>

    I am wondering if there is any place for me to custom it ? can you help me ?

  17. I am keeping a personal project log - nothing fancy, just one page with a TOC by date. The page is lengthy now and if I'm at the bottom of the page and I want to edit, I have to go to the top of the page to hit Edit then all the way back down to the bottom of the page to do the editing. Is there some way while at the bottom of a page to go into Edit mode? Thanks!

    1. The shortcut key e should help you out.  No need to hit ctrl / cmd  just the letter e on your keyboard and you will go straight to edit mode (you'll be at the top of the page, but it will have saved one long scroll). 

  18. After I hit "e" for edit, I then ctrl-end to go straight to the bottom of the page to pick back up on my editing. No scrolling!