WikiTraccs 1.23.16 (Prerelease)

WikiTraccs - Confluence to SharePoint Migration Tool

---

📥 DOWNLOAD RELEASE

📖 GENERAL QUICK START GUIDE ↗️

📖 HOW TO UPDATE ↗️

In this release:

Improvements

Confluence On-Prem & Cloud

• new: WikiTraccs migrates macros from the Include Content app by Keysight Technologies
  • the shared block macro content is now migrated as is, without surrounding text placeholders
  • the include shared block macro is now migrated as copy of the referenced "shared block" macro, instead of just a text placeholder
• improved: user @-mention link now contains user reference (like Confluence key or username) that can be used to identify and update the link in the future
• improved: connection check for chromedriver site got a retry as it sometimes failed with server error
• improved: monospace formatting is now preserved even when being on one line with differently formatted text
• fix: the cookies.txt authentication workaround was not compatible with Confluence Cloud; this has been fixed and the documentation has been updated as well
• fix: user @-mention link in page not properly generated if there is no email address present for Confluence user (even when mapping to Entra ID user is present that would provide email); now the Entra ID user's email is used when generating the link
• fix: edge case where a user mapping would not be applied if the local cache contained the Confluence user's email, but the user mapping list not

Confluence On-Prem

• improved: retrieval of Confluence user's email address from Confluence via alternative endpoints; this improves auto-mapping to Entra ID accounts

Confluence Cloud

• fix: whiteboard import working again; needed to be adjusted to changed HTML structure

Preparations for New Page Editor Version Support

This release contains preparations to create pages using the latest version of the page editor as this feature should now be fully rolled out to all tenants by Microsoft.

Background: Microsoft started updating its page editor around the end of 2023 and continued improving it throughout 2024. Pages that are or have been created in the previous format are updated as soon as they go into edit mode the first time. You see that with migrated pages as there will be a small delay the first time you edit a page. This is JavaScript running and upgrading the page to the latest version.

WikiTraccs will soon start generating pages with the latest version. Going forward, this makes it possible to leverage the full potential of additional formatting options and new web parts.

You shouldn't notice any changes, yet. The switch will be announced and there'll be a toggle button to switch back if necessary.

Progress is tracked here: #148

New: WikiTraccs for Markdown

WikiTraccs gains the ability to publish Markdown files to SharePoint. This release includes an early implementation to gather feedback.

Join the waitlist and receive updates.

Read the blog post to learn how to test: Testing WikiTraccs for Markdown

---

Your users need a SharePoint 🌳 page tree 🌳 and breadcrumb, just like in Confluence. WikiPakk has got you covered! Head over to wikipakk.com to learn more, or get it straight from Microsoft AppSource.

---

You agree to the Terms of Service by downloading and using WikiTraccs.

WikiTraccs 1.22.11

WikiTraccs - Confluence to SharePoint Migration Tool

---

📥 DOWNLOAD RELEASE

📖 GENERAL QUICK START GUIDE ↗️

📖 HOW TO UPDATE ↗️

In this release:

New: Live Progress Indicators

This release introduces an often asked-for feature: live metrics for the migration which show the current migration speed which also might indicate how long the migration will take.

Learn more in the documentation: Live Progress Indicators.

And here's a blog post showing some test migrations and their metrics: How much time will a Confluence to SharePoint migration take?

Note: metrics will be shown in "migrate content" mode, the other modes are not yet supported.

New Features & Improvements

Confluence On-premises & Cloud

• new: the number of pages for a space (or more broadly: selector) and the number of migrated pages are written back to the Space Inventory SharePoint list, making it easier to see progress per selector
  • look at the WT_In_CfPageCount and WT_Out_CfTransformedPageCount columns (note: you might have to add these to the list view)
  • the values are updated once when starting and once when finishing the migration, at the same time the progress log files are written
• new: adding support for the Children Display macro; it is now transformed as static snapshot as well (like the Table of Contents and Page Tree macros)
  • note that the snapshot will always show links, no page previews
• new: adding support for colored and merged table cells in SharePoint; read the blog post: Making SharePoint tables look pretty.
• new: warnings and errors are saved to a separate log file, making analysis easier (note: this is a copy, they also can be found in the big common log file)
• improved: supporting additional page hard link format for link transformation (homepage link)
• improved: supporting additional space hard link format
• fix: connection test fails for anonymous authentication mode on some sites, as the JSESSIONID cookie seems to be missing
• fix: space hard link transformation
• fix: "update author and editor" mode was broken due to header-related assumptions introduced in release v1.21.11

Confluence Cloud

• improved: hard link transformation now transforms links to new content types (whiteboard, ...)
• improved: modification dates for new content types (whiteboard, ...) is now retrieved as well and used to detect changes on consecutive migration runs (delta scenario)

---

Your users need a SharePoint 🌳 page tree 🌳 and breadcrumb, just like in Confluence. WikiPakk has got you covered! Head over to wikipakk.com to learn more, or get it straight from Microsoft AppSource.

---

You agree to the Terms of Service by downloading and using WikiTraccs.

WikiTraccs 1.21.11

WikiTraccs - Confluence to SharePoint Migration Tool

---

📥 DOWNLOAD RELEASE

📖 GENERAL QUICK START GUIDE ↗️

📖 HOW TO UPDATE ↗️

In this release:

WikiTraccs switches to Confluence Cloud REST API v2 (mandatory as of December 2, 2024 March 31, 2025)

Note: This topic is only relevant when migrating from Confluence Cloud. Confluence Server and Data Center are not affected.

WikiTraccs switches over from Confluence REST API v1 ("on-prem API") to v2 ("cloud API") which is a pretty big change (#118). Atlassian is removing critical v1 endpoints on Dec 2, 2024 and forces app vendors to use v2, although this new version requires significantly more API calls (which makes it slower) and is more cumbersome to use.

WikiTraccs has been undergoing intensive v2 adjustment and testing over the the last couple of months. So far it used mainly v1 endpoints but now switches to v2.

Ideally, there should be no differences for users of WikiTraccs.

Here's the announcement in the blog: WikiTraccs switches to Confluence Cloud v2 REST API.

Note: Atlassian extended the deadline one day after this release.

WikiTraccs brings the margins back to text web parts

SharePoint pages are now created in a way that brings the margins back to text web parts.

Some time in 2024 Microsoft changed something in text web parts. Margins between paragraphs disappeared gradually. Now the margins are nearly always missing, making paragraphs of text stick together more than they should. You'll notice that with pages migrated so far. The margins can be brought back by editing the pages and changing the style from "No spacing" to "Normal".

From now on, WikiTraccs sets a flag on pages it creates that brings the margins back by default, although they are a bit larger compared to manually created pages. This has technical reasons and will be tackled in a future release.

Only if you don't want the margins back, you activate the old behavior with the following configuration in appsettings.json:

{
  "CustomSettings": {
    "Features": {
      "GlobalRichTextStylingVersion": 1
    }
  }
}

Other Improvements

Confluence On-premises & Cloud

• improved: SharePoint pages now have their First Published Date set, as well as the Author; this makes migrated Confluence blog posts appear at the right place in news web parts (previously they would show up as new)
  • the First Published Date is set to the Confluence page creation time
  • the Publisher is set to the creator of the Confluence page
  • the change should also be noticeable in the SharePoint page header, when using a SharePoint page template that shows this information
• improved: attachments that are reported as "not found" by Confluence when downloading (although they are listed as page attachment) are now logged as transformation error
• fix: handling of attachments where the name only differs by Unicode Normalization Form; WikiTraccs renames the quasi-duplicates because SharePoint doesn't support that; also, a transformation error will be logged
• fix: handling of duplicate attachments; same procedure as above

Confluence Cloud

• fix: nested task list items could be missing after transformation since the task list format changed in Confluence Cloud; affected SharePoint pages can be identified by the "Text Transferred Percent" metric being below 100
• fix: pages with empty title now migrate properly; the page file name will contain the word "MISSINGTITLEMARKER" where the title usually is located (so far I know of one confirmed case of a page with empty title)
• fix: looking up the target space id for a link could return a wrong one if the target space doesn't exist
• fix: a link to a database or whiteboard could prevent page creation
• fix: enhanced user profile macro transformation now also recognizes user account IDs

---

Your users need a SharePoint 🌳 page tree 🌳 and breadcrumb, just like in Confluence. WikiPakk has got you covered! Head over to wikipakk.com to learn more, or get it straight from Microsoft AppSource.

---

You agree to the Terms of Service by downloading and using WikiTraccs.

WikiTraccs 1.20.43

WikiTraccs - Confluence to SharePoint Migration Tool

📥 DOWNLOAD RELEASE

📖 GENERAL QUICK START GUIDE ↗️

📖 HOW TO UPDATE ↗️

In this release:

Improvements to Hard Link Transformation

Support for hard link transformation has been extended. For both Confluence on-prem and Cloud hard links are now properly transformed to SharePoint links when using API Keys to authenticate with Confluence.

Furthermore, support for additional Confluence Cloud hard link variations has been added (solves #117 and #119).

Read the blog post for more information about hard links and soft links: Confluence Link Types Explained.

Other Improvements

Confluence on-prem & Cloud

• improved: adjusting log output for common errors to be more sensible with regard to log levels - makes checking the logs easier
• improved: adding handling for rare case of Confluence failing to covert a table of contents macro
• improved: more log output regarding Entra ID authentication and SharePoint site access to facilitate diagnosing permission-related issues; samples have been added to the troubleshooting section of the Registering WikiTraccs as app in Entra ID blog post
• fix: content of expand macro, that is contained in a table, that only contains images, might be missing on transformed page; the "All Images Transferred" metric indicates this

Confluence Cloud

• improved: user name resolution for @-mentions via user key (this affects pages that have been migrated from Confluence on-prem to the cloud) (solves #114)
• improved: adjusted info emoji for info panel to look better
• improved: handling additional hard link variation (edit link to page)
• improved: transformed Jira issue lists now use the configured selection of columns and the display name instead of internal name
• fix: some pages have no position set, making their order undefined (which would affect WikiPakk); falling now back to manual on-prem order logic (might only affect migrated pages; technical details)
• fix: Whiteboard export might fail due to the page properties button having a changed structure
• fix: Jira issue lists won't be transformed if they contain multiple links in a column

---

Your users need a SharePoint 🌳 page tree 🌳 and breadcrumb, just like in Confluence. WikiPakk has got you covered! Head over to wikipakk.com to learn more, or get it straight from Microsoft AppSource.

---

You agree to the Terms of Service by downloading and using WikiTraccs.

WikiTraccs 1.20.31

WikiTraccs - Confluence to SharePoint Migration Tool

📥 DOWNLOAD LATEST RELEASE

📖 GENERAL QUICK START GUIDE ↗️

📖 HOW TO UPDATE ↗️

In this release:

Confluence Cloud - Migrating Whiteboards

This release is capable of migrating Confluence Cloud whiteboards to SharePoint Online.

Whiteboards will be exported as image, the SharePoint page will show this image. Whiteboard export is currently opt-in and needs to be enabled in the settings. It is in experimental state and needs to evolve as the number of whiteboard migration grows.

Note: Atlassian does not provide an official way for applications like WikiTraccs to export whiteboards automatically and at scale. WikiTraccs thus resorts to browser automation. It will open whiteboards in a browser and automatically "click" the buttons needed to export the whiteboard as image. This method can work well, but is prone to breaking if Atlassian changes the user interface. This will need to be adjusted as needed - until Atlassian provides a proper export endpoint. This ask is tracked in CONFCLOUD-76634.

Note: WikiTraccs cannot yet detect empty whiteboards and those fail to export. This is a known limitation.

Other Improvements

Confluence Cloud and On-prem

• improved: image scaling; image sizes now match the source more closely, and scrollbars in tables are prevented
• improved: only accounts of page authors were added to the user mapping table, now the last editor is added as well
• improved: better handling of more complex link contents
  • sometimes you might see this in pages, where WikiTraccs wasn't able to handle a link that had some "content" in it:
    
  • this should now look like this instead, which helps de-cluttering pages:
    
• improved: converting three-column layouts with empty columns left and right to one-column in SharePoint, to use available space
• fix: page tree macro conversion fails if the search box is on in the macro settings
• fix: images that link to PSD files were converted to text placeholder; will become attachment links now
• fix: SVG image scaling to zero size issue, making images appear missing
• fix: file names with control characters could prevent a page from being created (how does "Ctrl+C" end up in a file name?)
• fix: special characters in commentators names could make page transformation fail
• fix: link resolution might fail for ID-only links that miss the target content type

Confluence Cloud

• new: added transformation for decision lists
• fix: modification date and author for new content types (whiteboard, database, etc.) were missing in the last prerelease
• fix: emoji conversion - cloud-specific ones are now handled correctly (#27)

---

Your users need a SharePoint 🌳 page tree 🌳 and breadcrumb, just like in Confluence. WikiPakk has got you covered! Head over to wikipakk.com to learn more, or get it straight from Microsoft AppSource.

---

You agree to the Terms of Service by downloading and using WikiTraccs.

WikiTraccs 1.20.15 (Prerelease)

WikiTraccs - Confluence to SharePoint Migration Tool

📥 DOWNLOAD RELEASE

📖 GENERAL QUICK START GUIDE ↗️

📖 HOW TO UPDATE ↗️

In this release:

General Improvements

• new: the Include Page macro is transformed to a link to the corresponding SharePoint page
• improved: removing empty entries from transformed Table of Contents macro

Confluence Cloud - Preparing for Migration of new Content Types

This release adds further support for the new Confluence content types like whiteboard, database, folder, and smart link. Those will not be migrated yet. But a new SharePoint page will already be created, although an empty one. Future releases of WikiTraccs will add migration support for those new content types.

Migrating the new content types to empty pages has already one benefit: all metadata will be present in SharePoint that is required to rebuilt the Confluence page tree. If you use WikiPakk to show the Confluence page tree in SharePoint, this will now show the whole tree, regardless of content type.

Proxy Mode Improvements

Note: Those changes only apply if you have the "Proxy Confluence API calls through browser" setting activated.

• improvement: automated browser is more resilient against accidental closing; will reopen
• fix: relative link issue in proxy mode with cloud site that redirects after logging in
• fix: modified JavaScript to handle missing page body (when page loads slowly)
• fix: adding CORS error handling
• fix: failed external file downloads could cause a lot of retries with way too long timeouts

Updating to .NET 8

Microsoft is deprecating .NET 6 in a couple of weeks, forcing the update to .NET 8. This should make no difference from an end-user point of view.

---

Your users need a SharePoint 🌳 page tree 🌳 and breadcrumb, just like in Confluence. WikiPakk has got you covered! Head over to wikipakk.com to learn more, or get it straight from Microsoft AppSource.

---

You agree to the Terms of Service by downloading and using WikiTraccs.

WikiTraccs 1.20.6 (Prerelease)

WikiTraccs - Confluence to SharePoint Migration Tool

📥 DOWNLOAD RELEASE

📖 GENERAL QUICK START GUIDE ↗️

📖 HOW TO UPDATE ↗️

In this release:

New transformation capabilities

• new: page header template support; here's how:
  1. create a SharePoint page template with name migration-template.aspx (that is the file name, not the page title; the title of the template page doesn't matter)
  2. all newly migrated pages will now get the same header as the template page in the same site
  • note: this is a per-site configuration; each site can have their own migration-template.aspx that applies to all pages migrated to the same site; sharing a template across sites is not possible at the moment
• new: macro placeholder customization using transformation templates
  • macro placeholders can now defined via Handlebars template
  • that means you could now get rid of the 🚧 placeholder and define your own placeholder text, for each macro
  • Documentation: Macro Placeholders and Transformation Templates
• new: adding explicit support for language macros from Bitvoodoo's Translation for Confluence

Lots of small improvements (PART 3)

• improved: better handling of certain cases of nested sections, columns, and macros
• improved: support for horribly broken macros in pages; WikiTraccs tries some fixing
• improved: memory management to better support long-running migrations under low-memory conditions
• improved: more diagnostic output for rare "Not a GET query" connection issue
• improved: Draw.io embed macro transformation now supports diagrams embedded from other pages
• fix: nested aui tab macros screw with the "handled macro percent" metric
• fix: "non breaking space" unicode character in page titles breaks attachment links
• fix: images with links were not immediately clickable, but required a page edit first
• removed the "Use M365 PnP Client ID" shortcut button as Microsoft retired the PnP Entra ID application on September 9, 2024

Confluence Cloud

• improved: panel transformation now takes the panel's emoji and color into account

---

Your users need a SharePoint 🌳 page tree 🌳 and breadcrumb, just like in Confluence. WikiPakk has got you covered! Head over to wikipakk.com to learn more, or get it straight from Microsoft AppSource.

---

You agree to the Terms of Service by downloading and using WikiTraccs.

WikiTraccs 1.19.13

WikiTraccs - Confluence to SharePoint Migration Tool

📥 DOWNLOAD LATEST RELEASE

📖 GENERAL QUICK START GUIDE ↗️

📖 HOW TO UPDATE ↗️

In this release:

Lots of small improvements (PART 2)

Confluence on-prem & Cloud:

• new: migrating image captions
• new: handling Spreadsheet macro
• improved: supporting links on images that start with //
• improved: handling images that link to non-image files instead of an actual image (like .msg email file); those will be converted to simple links
• improved: handling of attachment thumbnails; thumbnail images will be downloaded and treated as additional attachments of the page they appear in
• improved: better error handling and display for connection tests in WikiTraccs.GUI
• improved: Selenium proxy mode now only downloads one Confluence attachment at a time to increase resilience
• improved: marker for added table cells
• improved: handling of even more non-standard tables
• fix: issue with generated links when more than one view-file macro is on one page
• fix: handling of inaccessible Jira issue lists as anonymous user
• fix: Selenium proxy mode could show mixed-content warning when downloading http resource; will upgrade to https and try again
• fix: Selenium proxy mode could run into timeouts for larger attachments
• fix: lowering the number of IDs per CQL query for content ID selectors even more to 200 to work around Server Error issue
• fix: content of non-standard list content in nested lists could be missing (note: this would be indicated by < 100% text transferred metric)
• fix: handling of empty table filter macro - it will now be removed
• fix: empty table of contents macro needlessly transforms to text placeholder - will now be removed

Confluence Cloud:

• improved: link transformation for inline card links

---

Your users need a SharePoint 🌳 page tree 🌳 and breadcrumb, just like in Confluence. WikiPakk has got you covered! Head over to wikipakk.com to learn more, or get it straight from Microsoft AppSource.

---

You agree to the Terms of Service by downloading and using WikiTraccs.

WikiTraccs 1.19.5

WikiTraccs - Confluence to SharePoint Migration Tool

📥 DOWNLOAD RELEASE

📖 GENERAL QUICK START GUIDE ↗️

📖 HOW TO UPDATE ↗️

Note: the previous preview release v1.19.3 introduced a so far unknown HTTP header conflict that made Confluence on-prem fail to convert the page tree and table of contents macros to HTML. This has been fixed in v1.19.5. Please update to the new release when it becomes available.

In this release:

Lots of small improvements (PART 1)

Confluence on-prem & Cloud:

• new: Table of Contents macro migration (as static snapshot)
• new: transformation of Google Drive Link macro to regular link
• new: setting storage locations (in WikiTraccs settings dialog)
• new: setting to disable connection checks for troubleshooting purposes (in WikiTraccs settings dialog)
• improved: removed "Add caption here" being displayed for transformed images (in SharePoint)
• improved: transformation of .ico image files with certain MIME types
• improved: empty code macro transformation result
• improved: Confluence user name lookup in anonymous auth mode
• improved: adding more image to emoticon conversions (to prevent smilies from being served as image files)
• improved: Confluence connection tests (logging, error display, focus on supported TLS versions)
• improved: default values when opening the settings dialog the first time (enabling comments migration and downloading of external images by default)
• fix: wrong display size for images when EXIF rotation is set
• fix: rare case of inline images making code macro transformation fail
• fix: lowering the number of IDs per CQL query for content ID selectors from 500 to 300 to work around Server Error issue
• fix: page title with line break prevents page creation in SharePoint

Confluence Cloud:

• new: Panel extension transformation (#137)

---

Your users need a SharePoint 🌳 page tree 🌳 and breadcrumb, just like in Confluence. WikiPakk has got you covered! Head over to wikipakk.com to learn more, or get it straight from Microsoft AppSource.

---

You agree to the Terms of Service by downloading and using WikiTraccs.

WikiTraccs 1.18.19

WikiTraccs - Confluence to SharePoint Migration Tool

📥 DOWNLOAD LATEST RELEASE

📖 GENERAL QUICK START GUIDE ↗️

📖 HOW TO UPDATE ↗️

In this release:

• improved: removing more blocking user interface elements in automated Chrome browser, like the search engine selection dialog
• improved: better duplicate page remediation; when duplicate page IDs are returned by Confluence (rare cases, but it happens), WikiTraccs falls back to "manual" page tree traversal which seems to reliably get all pages for a space
• fix: adding option to (hopefully) work around the "DevToolsActivePort file doesn't exist" error (#136):
  

---

Your users need a SharePoint 🌳 page tree 🌳 and breadcrumb, just like in Confluence. WikiPakk has got you covered! Head over to wikipakk.com to learn more, or get it straight from Microsoft AppSource.

---

You agree to the Terms of Service by downloading and using WikiTraccs.