"Our Confluence cloud migration was a great success"… Was it though?

We - just like many of our customers - are faced with a lot of Software manufacturers shifting towards Cloud-First strategies. One of them is Atlassian. 250 colleagues are using Confluence, Jira Software and Jira Service Management day in and day out - all still hosted on our servers, up until July 2023, where we made the switch to Confluence Cloud.

With Confluence being the most simple App of the three, we thought best to start with that. “Only” 136 Spaces, 22.550 Views and 2.500 Edits (Stats from Nov 23) and not too much custom configurations should make the transition easy and a good place to start our migration journey.

Today, about half a year later, we are looking back at the migration itself, what we learned from it and give you the questions we know you should ask your users, because we did not.

The Plan

We started to plan the migration in early 2023. After the initial decision for the move towards Cloud and a rough project plan we already had an info session for all colleagues and with it opened up the communication channel to the migration team. We were gonna conduct several test migrations, learning on the way and including several power users in at least the last stages of testing. Some of the technical difficulties we already planned for. Also we were gonna inform our collagues continuosly on our progress and teach them about the changes between Server and Cloud right after the migration.

The Challenges

It turned out, that even though there isn’t that much to configure in Confluence (compared to Jira anyway), Third-Party-Apps, the use of macros (even Atlassian native ones) and page restrictions made it complicated enough. (Fun fact: Even Confluence Admins cannot access pages, when they are restricted so if they are restricted to old users, they are lost in the limbo.)

The Confluence Cloud Migration Assistant (CCMA) was still under development. So much so, that there sometimes were multiple updates in a week and not always for the better. Between our final test and the productive migration, one of said updates (to the CCMA or Confluence itself) brought several minor issues with it, that we first thought were our mistake. It took quite some time figuring out whether those were bugs or features.

Especially after user testing we realised, that there are significant differences between the Server and the Cloud version, specifically in the Editor’s capabilities. The “new Editor” is restrictive when it comes to nesting macros - a feature a lot of our pages were using. The UI and UX for tables is completely changed. The migration team thought not much of it, the users were confused and missed a lot of features. Even though we had an extensive testing catalogue, we hadn’t thought of every possible scenario and constellation. That meant some “intensive care” and lots of communication with the Atlassian Migration support after the actual migration.

What we learned from it

The plan was actually good and we stuck to it. On the technical side of things, a lot of trial and error worked out well. We would advise you to keep up with the updates Atlassian is bringing to the Migration Assistants as they make your life easier - they now are in a more stable state and already contain many more features than there were in summer.

Especially informing all colleagues early on and in between helped getting feedback and preparing anyone for the big day. They knew roughly what was going to change and we filled in the details by conducting trainings right after the migration. However, we would rather get them involved much earlier into testing and actually using the new environment. Considering ressources (time, money and such), giving more people early access would have generated more in-depth feedback and cover more test scenarios and use cases. There were plenty of differences that we didn’t cover in our Post-migration-training, because we weren’t properly aware of them.

We thought we knew how our colleagues are using Confluence, because… How many ways could there be? Turned out, people get creative and so they should. Asking them about their use cases and finding out more about how our collagues actually use Confluence would have enabled us to either teach the right functions and features in the training or get us a headstart on what Apps/Add-Ons we may need.

Also, be realistic about the change towards Cloud. There are ups and downs to it. We certainly upsold the whole thing to an extent and might have caused some unrealistic expectations that we now are dealing with. That comes to show in a survey we conducted in November. Only 36% thought that Confluence Cloud brings more value to their work than Confluence Server. For 15% Confluence Cloud wasn’t fullfilling their expectation regarding functionality and performance. On a positive note, over 70% thought otherwise.

How to proceed

Regardless of the survey, we are already picking up the slack - quite literally. We have a Slack-Channel where our colleagues can post any questions regarding Atlassian and where we, the Atlassian Team, post Tips & Tricks, info and news on a regular basis. We try to match the posts with frequently (or recently) asked questions and noticed that a lot of “issues” with the products tend to come from missing knowledge rather than not missing features. We will continue to teach our colleagues on the capabilities and use cases of the tools and start with regular training sessions again shortly.

We are keeping the communication channels open to receive feedback and feature requests so we can improve the Atlassian products beyond what Atlassian brings with their product development anyway. Staying on top of those product changes is just as important, so you are not surprised by major updates (they are usually available to all users right away). At our “ShipIt-Day” (our yearly innovation event) some colleagues will test Apps and more products to see which meet our needs and are worth the extra cost. We hope to inspect diverse use cases and user needs to get a holistic view on what our requirements are.

For our upcoming Jira Migration we will overthink our testing procedures and involve our colleagues even more on the practical side of things. Also, we will use a checklist that - finally - contains the questions that were promised in the intro. You can download the checklist for free by clicking this button:

Please fill out the form and we will send the download-link.

Still unsure about your own migration?

Beyond sharing our own migration story, we are assisting others in theirs. As an Atlassian Solution Partner we are happy to chat to you about your Atlassian products, how to move them to Cloud or how to make the most of them.

Credits - Pictures from Freepik