WikiTraccs Hotspots
This article covers topics that are often hotspots in a demo or while evaluating WikiTraccs as migration tool.
Getting Started
This article will guide you to your first Confluence migration with WikiTraccs.
Only a few steps, BUT...
You need the following at hand in this guide:
- the means to authenticate with Confluence (version 6+, or Cloud)
- the means to authenticate with SharePoint Online
- two SharePoint sites
- the client ID of a registered Entra ID application (How to?)
Note that all of the above is mentioned in the quick start video below.
Quick Start Video - First Confluence Migration
Note: Some public Confluence instances for testing are lf-hyperledger.atlassian.net/wiki and https://wiki.unece.org.
Further Reading
The Hotspots page has lots of good links to help you get up to speed with topics like what can be migrated, and how to stay up-to-date.Let’s dive in.
STEP ONE: Download WikiTraccs
Click to open the WikiTraccs download page: DOWNLOAD page.
Download the zip file.
No installation required
WikiTraccs has no installer. It is provided as a portable version, which means you extract a zip file and run the program.Extract the zip file - it contains two folders WikiTraccs.Console and WikiTraccs.GUI.
In the WikiTraccs.GUI folder run WikiTraccs.GUI.exe.
Unblock WikiTraccs
Windows might block WikiTraccs.GUI.exe from running, showing a blue warning message. This message shows because the file has not been signed. Unblock the file:
- Open Microsoft Windows Explorer to locate WikiTraccs.GUI.exe
- Select WikiTraccs.GUI.exe with the right mouse button and choose Properties
- Click Unblock in the lower right corner of the resulting dialog(*)
- Click OK to close the dialog
(*) If the Unblock button or option is not present, the file is not blocked.
A blue-ish window opens. We’ll call this just WikiTraccs for the remainder of this page, instead of WikiTraccs.GUI.
Congratulations, you downloaded and started WikiTraccs.
Proceed with the next step.
STEP TWO: Configure WikiTraccs and test connections
The window you opened in the previous step should look like this:
WikiTraccs main view
You will now use this view to configure everything for a first migration.
Select the Confluence base address input field and enter the base address of Confluence. This is the source system whose content will be migrated to SharePoint Online.
Under Confluence authentication type select the authentication type to use. Choose Interactive login to open a browser window for logging in when starting the migration.
Select the WikiTraccs site input field and enter a SharePoint site address. Now is a good time to create this site.
WikiTraccs Site
WikiTraccs uses this site to store migration-related data. The site is also used to configure aspects of the migration. The site should not be used for other purposes.Click the Try to detect from site button to detect the SharePoint tenant ID. If this doesn’t work, enter the tenant ID manually into the Tenant ID input field.
Select the Entra ID Application Client ID input field and enter the ID of the Entra ID application that WikiTraccs should use to access SharePoint.
Where to get the Entra ID Application Client ID from?
Read the blog post Registering WikiTraccs as app in Entra ID for step-by-step instructions.
Refer to Authenticating with SharePoint for more general information.
Under SharePoint authentication type select the authentication type to use. Choose Interactive (MFA supported).
Proceed with the next step.
STEP TWO AND A HALF: Validate the configuration
Validating the Confluence connection settings
Click the Test Confluence connection button to test the Confluence connection.
With the Anonymous and Interactive login authentication types, WikiTraccs opens a browser window. It then navigates to the Confluence base address you entered in step two. Log in if you chose Interactive login as authentication type.
Wait for the browser window to close. This is important. It has to close by itself.
Note
When choosing Personal token as authentication type, no browser window will open. The token already combines a Confluence user identity and password, so WikiTraccs should be able to test the connection without showing a browser for login. Personal Access Tokens are available as of Confluence 7.9.A message box in the blue WikiTraccs.GUI window will open and tell whether the test succeeded or not.
Validating the SharePoint connection settings
Click the Test SharePoint connection button to test the SharePoint connection.
WikiTraccs shows the Microsoft 365 login. It uses an open browser window if it finds one, or opens a new one. Select that window and log in. A green bar should appear, saying Authentication complete.
Now select the blue WikiTraccs.GUI window again, bringing it back to the front.
A message box will open and tell whether the test succeeded or not.
Something didn't work?
If something goes wrong refer to the Troubleshooting section.When both of those tests were successful, click the Update Space Inventory in WikiTraccs site button. You might have to log in again.
If successful, a message box will open and show you the number of Confluence spaces that were found.
Proceed with the next step.
STEP THREE: Start the migration
First, you need to select the Confluence spaces to migrate.
Click the Open Space Inventory list to choose sources button.
A browser window opens, showing the space inventory SharePoint list. It contains information about all spaces that were found in Confluence. WikiTraccs filled this list when you clicked the Update Space Inventory in WikiTraccs site button in the previous step.
For each element in the space inventory list, choose the RequestTransformation option to include this space in the migration:
Include a Confluence space in the migration.
When you are finished, return to the WikiTraccs window.
Select the Default target site input field and enter the address of the target SharePoint site. This site will be the new home for migrated pages. Now is a good time to create this site.
Only one target site? No!
You can configure one default target site in the WikiTraccs.GUI user interface.
Additional target sites can be configured in the Confluence Space Inventory. The default will be used as fallback if a source selector has no target site set.
Configuring a different target site per space is possible via the WT_Setting_TargetSiteRootUrl column of the space inventory list. See How to map Confluence Spaces to SharePoint Sites for more information.
Click the Start transformation button to start the migration.
A new window opens - WikiTraccs.Console - and the migration begins.
Multiple log ins
You might have to authenticate twice because WikiTraccs.GUI first tests the connection, then hands over to WikiTraccs.Console which authenticates again.Congratulations. Your first migration is running.
Look at the Site Pages library of your target SharePoint site. After a minute or so new pages should appear. Those are the transformed Confluence pages.
Tip
To end the migration prematurely select the WikiTraccs.Console window and press Ctrl+C to shut it down. You can start it again at any time and it will resume where it left off.WikiTraccs Trial Version
This article covers the trial version of WikiTraccs and how it’s different from the licensed (full) version.
Last modified June 21, 2026