Quick Administrator Tips To Prepare for Confluence 4

We've put together some quick tips on how Administrators can prepare for Confluence 4:

1. Stay Updated On The Latest Docs

Watch the Planning for Confluence 4 page. We will update that page with more resources as we make further progress -  so make sure you stay updated!

2. Download, install and trial Confluence 4

We strongly encourage you to set aside some time to download and install the latest version of Confluence 4.x. You can be better prepared by conducting an upgrade of your data in a test environment to see how the upgrade goes. Don't forget to get your internal users (especially the power users) to try Confluence 4. Ask them to go to their complex pages and see what they look like in the new editor and get feedback from them.

3. Give us feedback!

We really would love your feedback as you trial Confluence 4. We've made it really easy to do so. All you have to do is simply click the "Got Feedback" button you see in the Confluence toolbar:

This feedback will go directly to the Confluence team.

(info) If you need support, please get in touch with our legendary support department at support.atlassian.com.

4. Upgrade your user macros - Now!

With the introduction of Confluence 4, all macros that are inserted in the editor will need to be entered using Macro Autocomplete, or through the Macro Browser. This includes User Macros too!

However, a problem with User Macros in the past was that the only way to insert them was if you knew what parameters were available - and that wasn't documented anywhere. 

Now, if you are running Confluence 3.4 or higher, we introduced the ability for an Administrator to make their user macros visible in the Macro Browser and Macro Autocomplete. So the good news is you can prepare for that now, without having to wait for your Confluence 4 upgrade. How do you do this? You will need to define parameters for your user macros. All the documentation on how to do this can be found here. We've also created two examples to help you get started.

(warning) Important: This is required to enable user macros in Confluence 4.

6. Test your plugins

Although not all plugins are compatible with Confluence 4 yet, you can still test a majority of your plugins in Confluence 4. We strongly recommend you try this and let Atlassian know if there are any issues. This is really important especially if you have custom plugins that you've built internally.

(question)  How do I migrate my plugins to Confluence 4? All this information for plugin developers can be found from the Planning for Confluence 4 landing page.

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport