Confluence 4.1 Release Notes

13 December 2011

With great pleasure, Atlassian presents Confluence 4.1. With numerous improvements for content presentation, it delivers the extraordinary new Autoconvert feature, along with attractive new image effects, find and replace, new icons, improved translation features and global PDF stylesheets.


Highlights of Confluence 4.1:


 Thank you for your feedback:

More than 35 requests implemented
Over 185 votes fulfilled



OnDemand Customers

Confluence OnDemand customers will be automatically upgraded to Confluence 4.1 in the next scheduled maintenance window.

Highlights of Confluence 4.1


When you paste URLs into Confluence, Autoconvert will now analyse what you are pasting and automatically convert it into something that will display well in Confluence. Examples include YouTube videos, JIRA issue queries and Google Maps; many other content types are supported.

YouTube URLs

Create the widget below with Autoconvert, simply by pasting the YouTube URL onto the page.

Paste this:

To get this:

JIRA Issues URLs

Create the JIRA list below  with Autoconvert, simply by pasting the JIRA query URL onto the page.

Paste this:

To get this:

Showing 20 out of 22212 issues Refresh

Google Maps URLs

Create the Google Maps Widget below with Autoconvert, simply by pasting the Google Maps URL onto the page.

Paste this:

To get this:

Other supported content types:

  • Confluence page, blog, comment, status, user links, 
  • Shared screenshot links from Skitch,
  • Google search results links,
  • Confluence shortcut links: when pasting these, just the name of the link content (minus the URL prefix) will be used as the link display name.


Image effects

Enhance the presentation of your images and screenshots with slick new border effects.

Click Effects to apply taped style, instant camera style, drop shadow style, captions and more.

See the documentation for more details.


Quick find and replace

Updating your wiki content is now easier with the new find and replace feature. Using familiar conventions, automatically find and replace specific text strings within your Confluence page or blog. It's also accessible with a keyboard shortcut Ctrl-F (Windows) or Cmd-F (Mac OS).

See the documentation for more details.


Follow Your Network On the Dashboard

See recent updates from just the people you follow in Confluence, with the new network tab on the Confluence dashboard. With this, following a few people in different parts of your company to make a quick filter of the main events happening outside your immediate team. 


Space attachments macro

The new Space Attachments macro allows you to show all the attachments in the current space on your page. You can even filter them by file extension. Previously, you've only been able to show the attachments on the current page, using the Attachments macro.

Simply type {space-attachments} into a page to use it.


Global PDF stylesheets

Set your custom PDF stylesheets at the global level, as with custom layouts. When there is no specific individual space stylesheet defined, PDF space exports will fall back to this global stylesheet. This means that users won't have to re-apply the same stylesheet to all their individual spaces. This is an efficient way of achieving one look and feel.

See the documentation for more details.


Use any character in page titles

Confluence now allows "special" characters in your page titles, such as semicolons and exclamation marks. This allows more descriptive page names and generally removes restrictions when creating page titles and naming your content.


New translation feature

For those customers working on creating translations of the Confluence user interface, the 4.1 release has a new feature that will help. After opening the Confluence dashboard, you can simply add this text to the end of your Confluence URL, like so:  

Then press Enter.

This will then cause each element of the user interface to display its special key name while Confluence is still in an interactive mode. This makes it easier to find the essential context for each key, which can then be searched on where you can enter an appropriate translation for your custom language pack.

The key names are displayed with a "lightning bolt" graphic between elements of the names. For example, the buttons will show up with elements shown like so:

For the Browse menu, you can find its associated key on  When you use this new translation feature, you can see the full context of the user interface elements. By understanding where a feature appears on the interface, for example the Browse menu, you can write a more meaningful translation for your users.

To turn off the translation view, use this:


Other improvements

As always, we have made various small improvements to Confluence.

General improvements

  • Favourites have been refined
     You'll now see a newly named and cleaner Favourites tab in your personal space. Additionally, the list of favourites is now paginated and you can click the stars to remove favourites.
  • Global plugin & macro timeout setting
    There is now a globally configurable timeout setting. This will stop pages going into a permanent loading state. In the past, this could lead to instability issues.
  • New JSON RPC
    Confluence now has a JSON RPC library. This offers a way for Javascript developers to more easily access the Confluence API. For more details, see the documentation.

Editor improvements

  • Copy and paste table improvements
    You can now copy and paste multiple table rows and entire tables. There are also new keyboard shortcuts. You can now use Alt+Up Arrow or Alt+Down Arrow to add a row above or below the current row.
  • Copy and paste list improvements
    If you copy and paste list items from one list to another, the list content will now be joined together as expected. 

New icons

  • Based on customer feedback, this version of Confluence has a number of redesigned interface and installer icons. These new designs add more of a contemporary look and feel and are aimed at improving icon consistency and ease of use in Confluence.

    General Confluence Icon

    Installer icons

    User Interface icons


Helping you transition to the Confluence 4.x generation

We've created a set of resources to help you manage the transition to Confluence 4.x. The change management resources are listed under the current documentation.

Note: The Wiki Markup editor has been removed in Confluence 4.x and replaced with a new XHTML-based editor. Please see  Why We Removed the Wiki Markup Editor in Confluence 4.0 for full details


Confluence Quick Reference Guide

Kick-start Confluence adoption with the Origami Necktie – full of tips and tricks to help your users get off the ground running. Get yours now!

Release notices

Upgrading from a previous version of Confluence

We strongly recommend that you back up your Confluence Home directory and your database before upgrading. Follow the normal upgrade instructions to upgrade your test instance to this release. 

When upgrading from a previous version of Confluence, if you have customised your cache settings (as documented in Production backup strategy href="/display/DOC/Cache+Performance+Tuning">Cache Performance Tuning) then you may run into memory problems during the wiki to XHTML migration. We are working to fix this in a later release, but in the meantime you can revert your ehcache.xml to the default version.

Removed functionality

Features removed from Confluence
  • Mail archiving
    This feature is being disabled by default in Confluence 4.1. However, it is still bundled as the Confluence Mail Archiving plugin, and easy to restore. Current users of the feature will not suffer any interruption, as the feature will be automatically kept in an operational state if you are using it. See details.
  • The SVG graphics library Batik 
    Any plugins that previously relied on the Batik package being provided by Confluence will now have to bundle their own version of Batik into their plugin. See details.

A big thank you to everyone who helps us ensure that Confluence keeps getting better and better!

The Confluence 4.1 team


Ryan Ackley
Nabeelah Ali
Richard Atkins
Niraj Bhawnani
Joseph Clark
Paul Curren
Lachlan Dally
Chris Darroch
Anna Dominguez
Matthew Erickson
Steven Haffenden
Chris Kiehl
Fabien Kraemer
Daniel Kjellin
Steve Lancashire
David Loeng
Brian Nguyen
Craig Petchell
Agnes Ro
Matt Ryall
Stefan Saasen
Sam Tardif
David Taylor
Ryan Thomas
Wesley Walser
Don Willis
Joe Xie

Charles Miller

Build and release engineering
Adrián Deccico

Plugin updates
David Chui
Philip Cher
Kai Fung Chong


Product management
Bill Arconati
John Masson

Product marketing management
Ryan Anderson
Terrence Caldwell
Matthew Hodges

Development manager
Jonathan Gilbert

Cross Team

Henry Tapia

Quality assurance 
Joey Corea
Mark Hrynczak
Glenn Martin

Technical writing 
Edwin Dawson


Sydney support
Vincent Choy
Partha Kamal
Donna McGahan
Michael Seager

Amsterdam support
Tony Atkins
Sherali Karimov
Dennis Kromhout van der Meer

Brazil support
Rodrigo Adami
Tiago Kolling Comasseto
Guilherme Heck
Alyson Reis

Kuala Lumpur support
Husein Alatas
Janet Albion
Septa Cahyadiputra
Kah Loun Foong
Sim Foo Guan
Heng Hwa Loi
Joachim Ooi
Hanis Suhailah

San Francisco support
Rick Bal
David Chan
Robert Chang
Ty Davis
Marian Finch
Adam Laskowski
Brad Mallow
Wayne Tombo
Timothy Wong

Integration management
Melanie Carasso
Ted Tencza

Integration development
Sam Le Berrigaud
Don Brown
Trevor Campbell
Shihab Hamid
Adrian Hempel
Justin Koke
Peggy Kuo
Mark Lassau
Olli Nevalainen
Tim Pettersen
Felix Schmitz
Piyawoot Songsiritat
Joseph Walton
James Wong


Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

17 Archived comments

  1. User avatar

    Gerhard Müller, TNG Technology Consulting

    Congrats to the release! Is there any special reason why the personal labels have been removed?

    13 Dec 2011
    1. User avatar

      Sherif Mansour [Atlassian]

      Thanks for the feedback, Gerhard! With our goal to continue to simplify the product, we removed personal labels due to their extremely low usage and additional complexity they added.

      13 Dec 2011
    1. User avatar

      Mark A. Ziesemer

      I created a new issue for this on the public issue tracker at .  An enterprise support ticket on will also follow shortly.

      In summary, I'm finding it very difficult to understand how features removed like this follows Atlassian's stated company values, at least without any prior gathering of customer feedback (at least not visible to most of us).

      Please, please restore this feature with the next Confluence update.

      14 Dec 2011
  2. User avatar

    Tin Pham

    I just upgraded from 3.5.5 to 4.1 manually and everything went well. I must commend the team as 4.1 looks very polished and appreciate retaining tar.gz version for power admins like myself as it makes my job so much easier.

    Maybe I'm missing something, but shouldn't the release notes or documentation note that there are new startup and shutdown files being used? See my comment on the manual upgrade.

    15 Dec 2011
    1. User avatar

      Anatoli Kazatchkov [Atlassian]

      Hi Tin,

      Thanks for the compliments. I seem to remember that we modified documentation to include the description of startup and shutdown scripts. I will find out and answer your comment on the manul upgrade page.

      15 Dec 2011
  3. User avatar

    Fabian Lopez

    So far it looks very good. Is there any reason why the tooltip on linked images are not working anymore? I entered that as a question on Answers and on Confluence bug tracker (with screenshots).

    CONF-24161 - No tooltip over images with link on Confluence 4.1 Resolved

    I tried entering as wiki markup or macro browser and I am still not able to activate the image tooltip. It shows just the name of the picture instead of the page name or custom tooltip... (sad)


    ouch! I found this today  CONF-18668 - Links Browser: Editing a link will remove existing tooltips Resolved

    19 Dec 2011
  4. User avatar

    Susan Grodsky

    These release notes don't tell me what I need to know.

    Has the bug that causes broken links been repaired? I entered a CS case for this issue CSP-73403. It got consolidated into CSP-73402 and, after much conversation, remains unresolved.


    13 Jan 2012
    1. User avatar

      Matt Hodges [Atlassian]

      Susan, you'll find a link to Issues Resolved in Confluence 4.1 at the top of the page. You may also want to check out the Confluence 4.1.2 Release Notes

      13 Jan 2012
      1. User avatar

        Susan Grodsky

        Thanks Matt, I did eventually find the link on my own.

        The bugs that are really bothering me didn't get addressed and, after blithely installing 4.0, I am gun-shy. Think I'll wait for a few more updates.

        I'm so sorry to be expressing these hard words about 4.0, but you used to be a great product, and I still grieve for 3.x.

        13 Jan 2012
  5. User avatar


    Is there a page tree alternative to the old 'View in Hierachy' option? Just upgraded from an early 3.x far so good but as we move a lot of pages around would be great to be able to see the tree structure while doing this...

    06 Feb 2012
    1. User avatar

      Sarah Maddox [Atlassian]

      Hallo Anonymous (smile)

      The "View in Hierachy" option has moved to the "Tools" menu. It would indeed be a shame to lose it!

      Cheers, Sarah

      06 Feb 2012
      1. User avatar


        Thanks! Will log-in next time I promise!

        07 Feb 2012
        1. User avatar

          Sarah Maddox [Atlassian]

          Heh heh.

          07 Feb 2012
  6. User avatar


    The plain text editor is still not back. With the current editor I can not even copy paste my entire page and get it back the same way it appears on the source page. This happens in my case for a crossed out bulleted list. Yes, this is very specific, but I did not look at any other probably existing bugs. This is simply a prove that we are in urgent need of a plain text editor. The current "great feeling" editor simply does not do the job that the most basic editor should have, i.e. copy and paste in a consistent manner.

    07 Feb 2012
    1. User avatar

      Anatoli Kazatchkov [Atlassian]

      Hi Anonymous,

      You might want to read about our approach and about steps we are taking to address some of the common concerns with the new editor.

      07 Feb 2012
  7. User avatar

    Chris Ridgeway

    This page talks about image captions:

    Click Effects to apply taped style, instant camera style, drop shadow style, captions and more.

    Yet I've tried to do this on our Confluence 4.3 instance, and dont' see the option. Is this page wrong? What am I missing?


    10 Aug 2012
    1. User avatar

      Sarah Maddox [Atlassian]

      Hallo Chris

      (star) Thanks for making this comment! (star) 

      It is possible to add a caption, and it's just taken me half an hour to figure out how to do it. (smile) You need to add a comment to the attachment in the 'Attachments' view of the page, and use the 'Instant Camera' image effect when displaying the image on the page.

      That's not exactly intuitive. Also, you'll need to re-do the comment each time you upload a new version of the image.

      I'll update the documentation right now.

      Cheers, Sarah


      11 Aug 2012
Powered by Confluence and Scroll Viewport