This documentation relates to Confluence 3.1.x
If you are using an earlier version, please view the previous versions of the Confluence documentation and select the relevant version.

Rich Text Editor Overview

Introduction

The Rich Text editor provides users accustomed to HTML editing or other text editing applications, an easier and faster way to creating Confluence pages. It allows you to enter content as you would in a Word document, and apply formatting simply by clicking icons on a toolbar.

The 'Edit' screen lets you switch between 'Rich Text' and 'Wiki Markup' edit modes without losing the changes you've made; so you can use a combination of both while editing. For instance, you can use the rich text editor to change the text colour and then switch to Wiki Markup to create links.

You can also set the editor to open either the 'Wiki Markup' or 'Rich Text' editors by default, depending on your preference.

You can run the editor in a full-screen editing mode by clicking this icon at the far right of the toolbar.

Rich Text Editing can be disabled
This option is enabled by default. Be aware however that site administrators can disable it. If it is disabled, a site administrator will need to enable it again from the Administration Console before you can start using the Rich Text editor.

Right-click Context Menu

The Rich Text editor incorporates a right-click context menu that provides an additional mechanism for handling common editing actions available through the toolbar icons or keyboard shorcuts. For more information about the right-click context menu, refer to Rich Text-Right-Click Context Menu.

Drag and Drop

You can drag a file such as an image, Office or PDF file from your computer and drop it directly into the Rich Text Editor. The contents of the file will be embedded directly onto the page or blog post and displayed in its entirety when viewed. Please refer to:

  • Drag-and-Drop for more information about Confluence's drag and drop feature and prerequisites for setting this up
  • Inserting an image for more information about embedding images onto a Confluence page or blog post
  • Displaying Office Files in Confluence for more information about embedding Office and PDF files onto a Confluence page or blog post

Screenshot: The Rich Text Editor

RELATED TOPICS

Enabling Rich Text Editing
Making Rich Text or Wiki Markup Editing Default
Rich Text-Right-Click Context Menu
Rich Text-Working with Text Effects
Rich Text-Working with Tables
Rich Text-Inserting an image
Rich Text-Creating and removing a link
Rich Text-Linking to an Image
Rich Text-Linking to an Attachment
Rich Text-Linking to a Page
Rich Text-Inserting emoticons
Rich Text-Inserting Symbols

Labels

richtext richtext Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.
  1. Apr 18, 2007

    Yao Ge says:

    as of version 2.4.4, there is a serious problem with color formatting macro and ...

    as of version 2.4.4, there is a serious problem with color formatting macro and Rich Text Editor. When a link is inserted into a color formatted text block via Rich Text Editor. It will mess up not only the formating but also the link itself.

  2. May 25, 2007

    Daniele Raffo says:

    As of v2.5, the Rich Text Editor cannot be used to edit or even to look at a pa...

    As of v2.5, the Rich Text Editor cannot be used to edit or even to look at a page containing {code} tags.
    Opening such a page completely destroys the layout (many lines are merged on a single line) and content (special characters such as _ and * are escaped) of the code embedded in the {code} tags.

    If at least one page of your wiki contains source code formatting, you should not set Rich Text as the default editor.

    A workaround is to use the {noformat} tag instead.

    1. Jul 21, 2008

      Anonymous says:

      Horrible workaround. Why is rich text editing not a core feature?

      Horrible workaround. Why is rich text editing not a core feature?

  3. Jul 21, 2008

    Hai Nguyen says:

    Does anyone know, in Confluence 2.8, if the switching back and forth betwee...

    Does anyone know, in Confluence 2.8, if the switching back and forth between Rich Text Editor and Wiki Markup will screw up some of the wiki codes on the page as it did for older versions? It would be nice to have both choices compatible with each other.

    1. Jul 22, 2008

      Ming Giet Chong says:

      Hi Hai, This is an umbrella issue being tracked at: http://jira.atlassian.co...

      Hi Hai,

      This is an umbrella issue being tracked at:

      Please add in your comment and add yourself as a watcher to the bug issue for future updates. Thanks.

      Regards,
      MG

  4. Aug 21, 2008

    nana says:

    Hello, I know that some macros are not rendered correctly in the RTE and show u...

    Hello,

    I know that some macros are not rendered correctly in the RTE and show up as the script itself. Is there a way to set color to the macro so that users who are working in the RTE not modify these elements.

    I tried  to use the color tag but it does not work and breaks up the macros.

    Thanks

    1. Aug 28, 2008

      Azwandi Mohd Aris [Atlassian] says:

      Hi Nana, I am afraid that the markup, for instance, "{color:red}{mymacro}{color...

      Hi Nana,

      I am afraid that the markup, for instance, "{color:red}{mymacro}{color}" will not be helpful in this case. However, there is an ongoing feature request that addresses the needs to differentiate macros and normal contents in rich text editor:

      You might want to put your comments, be a watcher and cast your vote to increase the popularity of the request. Hope this helps.

      Cheers,
      Azwandi

  5. Oct 02, 2008

    Anonymous says:

    Is there a way to hide wiki code showing up in the rich text editor to simplify ...

    Is there a way to hide wiki code showing up in the rich text editor to simplify the editing UI and make sure folks don't muck up exact wiki code? For example, I'd like to include this wiki markup:

    ||  || Content allowed: 235x335 ||
    |  | !hspacer.jpg! |
    | !vspacer.jpg! | {table:width=235|height=335}
    {tr}
    {td}CONTENT GOES HERE "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.""Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore \\
    {td}
    {tr}
    {table} |
    

    But when someone is in Rich Text edit mode, I'd only like them to see the Confluence table and the spacer images and just be able to type into the "CONTENT GOES HERE" area to fill it up, and not see the red table info. Any suggestions?

    1. Oct 16, 2008

      Azwandi Mohd Aris [Atlassian] says:

      Hi, As far as I can think of, you might want to give the Scaffolding Plugin (th...

      Hi,

      As far as I can think of, you might want to give the Scaffolding Plugin (third-party plugin) a try.

      Cheers,
      Azwandi

  6. Nov 24, 2008

    Anonymous says:

    A quick question - can I add video to a page via the rich text editor?

    A quick question - can I add video to a page via the rich text editor?

    1. Dec 04, 2008

      Azwandi Mohd Aris [Atlassian] says:

      Unfortunately, the answer is no unless this feature request is realised. However...

      Unfortunately, the answer is no unless this feature request is realised. However, you can embed videos to a Confluence page, possibly by using:

      Hope that helps!

  7. Jan 26, 2009

    Anonymous says:

    Hi, i want to add a query from one database and get the query result and displa...

    Hi,

    i want to add a query from one database and get the query result and display it in a web page confluence format.

    Is there some way of i make it?

    1. Jan 28, 2009

      Zed Yap [Atlassian] says:

      Hi, As far i know, you can try the SQL plugin to query the database and display...

      Hi,

      As far i know, you can try the SQL plugin to query the database and display the result on a Confluence page. The documentation is provided below:

      Hope that helps.

  8. Feb 04, 2009

    Phil Wright says:

    Our Confluence server was recently updated to 2.10.  Since that time users ...

    Our Confluence server was recently updated to 2.10.  Since that time users are experiencing lost edits when editing pages with the Rich Text editor.  They enter changes.  Switch to Preview and their changes aren't shown.  Switch back to either the Rich Text or Wiki edit modes and the changes aren't there.  If you start off editing in Wiki Markup the changes are kept.

    I suspect some Confluence or Tomcat configuration was lost in the upgrade but the IT dept has no idea.  Anyone know what causes this and can anyone provide a pointer to docs explaining what to change to correct this problem.

    Thanks.

    1. Feb 04, 2009

      Mark Hrynczak [Atlassian] says:

      Hi Phil, It sounds like you have come across this known issue: CONF-14018. Thi...

      Hi Phil,

      It sounds like you have come across this known issue: CONF-14018.

      This has now been fixed - you can find a patch on the linked issue.

      Sorry about that,
      Mark

      1. Feb 05, 2009

        Phil Wright says:

        I bet that is it.  Thanks for the heads up!

        I bet that is it.  Thanks for the heads up!

  9. Feb 06, 2009

    Thomas Wolff says:

    Has anyone complained about or addressed the problem with the editor (in Conflue...

    Has anyone complained about or addressed the problem with the editor (in Confluence 2.8.2) adding hypertext "&nbsp" (no-break space) instead of regular "space" character as users enter text in the Rich Text space. It seems to happen when the user takes a break from fluid typing. This "&nbsp" sometimes is appended at the end of link text, thereby appending text to the link, which breaks it. Users forget to double check links in the Wiki Markup or Preview tabs. At other times, it just adds an extra space. As far as I can tell, this is the only hmtl code that the Rich Text editor adds on its own. As we are planning to upgrade to v. 2.10, has this problem gone away?

    While double-checking the previous paragraph in the Wiki Markup tab, I noticed that three instances of "&nbsp" have been created in this paragraph. I think that in each case I did something besides fluid input, things like backspacing, inserting text or deleting text highlighted with the mouse. Since this is v. 2.10.1-rc3, this problem obviously has not gone away. I can't train all my users to fix something that shouldn't be a problem anyway. Please look into this for all of us. Thanks.

    1. Mar 02, 2009

      Azwandi Mohd Aris [Atlassian] says:

      Hello Thomas, You might be interested in the following bug report: http://ji...

      Hello Thomas,

      You might be interested in the following bug report:

      I have also quickly tested this on a local Confluence 2.10. This problem does no longer exist in Confluence 2.10.x since the fix has been addressed by the aforementioned bug report.

      Cheers,
      Azwandi

      1. Mar 10, 2009

        Thomas Wolff says:

        Azwandi: We have just upgraded to 2.10.2 and I agree that the issue is SOMEWHAT...

        Azwandi:

        We have just upgraded to 2.10.2 and I agree that the issue is SOMEWHAT resolved.   characters are still added to the wiki markup, but at least links don't seem to be broken. We see a problem in pages that use excerpts, such as Forum tables using Community Bubbles 1.2. In this case, the   characters show up in the excerpt instead of the space that was intended. For example, see the "new group name" entry on http://wiki.piug.org/display/PIUG/Forum+-+PIUG+Discussion.

        I would like to see elimination of all random   characters except for well defined situations. For example, keep the   when a user explicitly add   to the wiki markup. Another situation is a bit less clear to me. I believe I have seen a user intentionally add multiple spaces in the rich text window in order to "indent" text. It maybe that multiple spaces are automatically reduced to just a single space under most circumstances. If the latter is true, then retaining multiple &nbsp: characters would be useful. If you can't think of other important situations calling for   instead of spaces, please eliminate them in the rich text editor. Thank you.

         Tom

  10. Mar 03, 2009

    Alison Paddock says:

    Has the color formatting feature been removed from the rich text editor? In the ...

    Has the color formatting feature been removed from the rich text editor? In the 2.9 version there was an artist's palette the toolbar. Many of my users are missing this in 2.10. will it be back?

    Thanks

    Alison

    1. Mar 03, 2009

      Mark Hrynczak [Atlassian] says:

      Hi Alison, The feature has not been removed. In 2.10 the the icon for selecting...

      Hi Alison,

      The feature has not been removed. In 2.10 the the icon for selecting colour was changed - it is now a capital 'A' with a grey bar underneath it. When you select a colour, the grey bar will change to show the colour you have selected.

      Also, the colour picker now appears in a dropdown, rather than a separate popup window. You can click on a default colour, or enter the hex value, as before.

      Cheers,
      Mark

      1. Mar 03, 2009

        Alison Paddock says:

        Thank you so much for your speedy response. The feature is much better!!...

        Thank you so much for your speedy response. The feature is much better!!

        Best wishes

        Alison

  11. Jun 22, 2009

    Anonymous says:

    Greetings, I have a problem with the Rich Text tab - it is absent in spite of t...

    Greetings,

    I have a problem with the Rich Text tab - it is absent in spite of the fact, that the setting “Editing Text With Formatting” was in the state “ON”.
    Would be grateful to receive an advice how to activate the Rich Text tab (Confluence v.2.10).

    Nik

    1. Jun 23, 2009

      Zed Yap [Atlassian] says:

      Hi Nik, You might want to check the supported internet browser and version for ...

      Hi Nik,

      You might want to check the supported internet browser and version for the Rich text editor. For more information please refer the following link:

      Get back to us, if you are still having problem with it.

      Best rgds,
      Zed

      1. Jul 07, 2009

        Lars Martinussen says:

        I have the same problem. Rich Text Editor not showing in IE 8, Opera 10 Beta. It...

        I have the same problem. Rich Text Editor not showing in IE 8, Opera 10 Beta. It seems to be working with Firefox 3.5 - but since my organization is using IE 7 (until all has updated) it is a problem. I dont want to run around and make sure everyone uses Firefox when they are editing pages...

        Confluence 3.0, runs on evaluation database (HSQL) and Vista (for evaluation purposes).

        Edit: Just figured out Confluence doesn't support IE 8 yet. What is your timeframe for including support for IE 8?

        1. Jul 07, 2009

          Anonymous says:

          Yep IE8 WYSIWIG menu/edit support broken it would appear in Conf 3.0x. If you ru...

          Yep IE8 WYSIWIG menu/edit support broken it would appear in Conf 3.0x. If you run IE8 in compatibility mode, it does mostly work OK. Only thing I noticed was that it keeps on wanting you to name the current page when you enable IE8 compatibility mode. Firefox is easier to work with though IMO. Digressing somewhat you'll find the Themebuilder plugin also has some issues with IE8, such as lack of vertical scolling but there are updates available from the vendor which largely fix things. Good luck. Cheers

        2. Jul 07, 2009

          Mark Hrynczak [Atlassian] says:

          Support for IE8 is being tracked as CONF-15413.

          Support for IE8 is being tracked as CONF-15413.

  12. Aug 24

    Anonymous says:

    Also not working with Safari 4.0 (is this a WebKit issue?) – no Rich Text ...

    Also not working with Safari 4.0 (is this a WebKit issue?) – no Rich Text Editing panel.

    1. Aug 24

      Zed Yap [Atlassian] says:

      Hi, Also not working with Safari 4.0 (is this a WebKit issue?) – no Rich Text E...

      Hi,

      Also not working with Safari 4.0 (is this a WebKit issue?) – no Rich Text Editing panel.

      As far as I know, the Rich Text Editor is not compatible with Safari 4.0 as stated in this documentation:

      I found an improvement report on this:

      Please add your comments to the discussion, vote on it and add yourself as a watcher for future updates. Also, please bear in mind the following document on how we schedule features for inclusion in our products: Implementation of New Features and Improvements.

      Hope that helps.
      Best rgds
      Zed

  13. Sep 21

    Anonymous says:

    Hi, When using the Rich Text Editor, how do I change the formatting or the pre-...

    Hi,

    When using the Rich Text Editor, how do I change the formatting or the pre-set formats (paragraph, H!, H2, etc).

    Also, Is there an easy way to indent blocks of text? I noticed that I can't indent blocks of text using the indent tool. It's only active when you have bullets and numbers.

    1. Oct 23

      Sashidaran Jayaraman [Atlassian] says:

      Hi, For the formatting using Rich Text Editor, the following documentation migh...

      Hi,

      For the formatting using Rich Text Editor, the following documentation might be able to guide you:

      1. Rich Text-Working with Text Effects

      As for the indentation, this is a bug which has been reported to us previously. I would suggest you to add yourself as a watcher for the mentioned bug report and feel free to comment or address your concerns through it. For further details on how we include new features and improvements, you might want to read this page

      Cheers
      JSashi

  14. Oct 02

    Eric Dion Baker says:

    Hello everyone - We are experienceing a large amount of our wiki markup being vi...

    Hello everyone - We are experienceing a large amount of our wiki markup being visible in the rich text editor, including toc and html tags, link-windows, etc.  any ideas as to why this would be happening?

    Thx,

    eric

Add Comment