Migrate from Confluence to XWiki

Supported Macros

When migrating from Confluence to XWiki, you will need to confirm that the identical macro exists in XWiki. This ensures that the pages that use Confluence macros and you import are displayed identically on the XWiki side. The majority of the macros you have been using in Confluence already have an equivalent in XWiki, but some may not. To ensure your team has a smooth migration process, we gathered a transparent, comprehensive and easy-to-follow comparison between commonly used Confluence macros and their alternatives in XWiki.
Confluence Macro Is migration supported XWiki Macro Additional info
  info Yes Info
  warning Yes Warning
  tip Yes Tip
  note Yes Note
  success Yes Success
  error Yes Error
  expand Yes
  toc Yes TOC
  toc-zone Yes
  anchor Yes Anchor
  children Yes Children The basic version of the macro is available. Some parameters may be missing.
  panel Yes Panel
  recently-updated Yes Recently updated
  status Yes Status
  details No
  contentbylabel No
  code Yes Code
  view file Yes View File
  section Yes Section
  column Yes Column
  excerpt Yes Excerpt
  include Yes Include
  page tree Yes
  tasks report macro Yes Task Manager Pro
  list labels No
  blog posts No Blog Application can be used as an alternative.
  attachments Yes Attachments
  create from template No The functionality is included in the standard «Create» wizard of XWiki.
  page tree search No Document tree and children macros can be used as an alternative.
  excerpt include Yes
  viewxls Yes View XLS
  viewpdf Yes PDF Viewer
  content report table Yes Content report table
  contributors No
  widget Partial Embed Macro
  roadmap No Diagram Pro can be used as an alternative.
  popular labels No Cloud of Tags can be used as an alternative.
  gallery Yes Gallery
  viewdoc Yes View Doc
  viewppt Yes View Ppt
  profile picture Partial User card macro can be used as an alternative.
  jira Yes JIRA The basic version of the macro is available. Some parameters may be missing.
  tasklist Yes Task Manager Pro
  change-history No The Confluence macro offers the same information as the XWiki History panel, which is displayed by default on the page.
  profile Yes User card macro can be used as an alternative.
  multimedia Yes Multimedia
  favpages No By default, XWiki comes with the pre-installed Like Application. This enables users to like pages and be able to find them in a directory of ”liked pages”.
  chart No
  drawio Yes Diagram Application (Pro)
  inc-drawio Yes Diagram Application (Pro)
  gliffy Yes Gliffy
  viewfile Yes View File
  task-list Yes Task Manager Pro
  htmlcomment Yes HTML Macro
  show-if Yes
  hide-if Yes
  card Yes Tabs Macro
  deck Yes Tabs Macro
  float Partial
  plantuml Partial PlantUML Macro
  redirect Yes Redirect Macro
  table-plus Partial Inline Table for LiveData
  attachment-table Yes
  navmap Yes
  iframe Yes HTML Macro
  roundrect Yes Panel Macro
  excel Yes
  img Yes
  alert Yes
For the macros that do not support migration and that are used on the Confluence instance, the wiki content will be imported, but they will not be displayed in XWiki identically to the Confluence counterpart. In view mode, an error message will appear, while in wiki edit mode, the syntax and content of the macro will be visible. As the wiki content will be imported and stored, if one of the currently unsupported macros will become available in the Confluence Migration Toolkit, the content will subsequently be displayed identically to the Confluence counterpart following the update and introduction of said macro. If one or multiple macros are required, the Client may choose to sponsor the development of those macros. Please contact us if you would like to inquiry about the development of certain macros.

Interested in talking with a specialist?

Send us a request and we will get back to you as soon as possible.