Confluence Migrator Application (Pro)

Last modified by Administrator on 2024/04/26 00:16

Buy extension
from 2000€ Try extension
for free Contact us

Category	Application
Active Installs	0
Rating	1 2 3 4 5 0 Votes
License	GNU Lesser General Public License 2.1
Minimal XWiki version supported	false
Sources	Issues

Migrate your Confluence data, users, attachments and metadata in just a few minutes using the multi space migrator.

To migrate from Confluence to XWiki you will need:

an XWiki instance with administrator access (advanced user, view hidden pages)
access to your XWiki instance's configuration files, if you are running XWiki on your premise
a Confluence server XML backup file

The application will take you through the few steps that are needed to complete the migration of a Confluence space. Please follow the instructions in the "Documentation" tab for a full breakdown of each step.

The Confluence Migrator Pro license and support is included in any Gold and Platinum support contract. In trial mode you will be able to import 30 pages per migration.

The application can be purchased individually only via online order (credit card payment), following the “How to Buy” procedure described in the "PRICING" tab. The application is part of the XWiki Pro package, which can be purchased through manual order (bank transfer payment) by contacting sales@xwiki.com.

Prerequisites
Data migration
Supported confluence macros

Prerequisites

an XWiki instance with administrator rights
access to your XWiki instance's configuration files (if you are running XWiki on premise)
Confluence Migrator Pro, Pro Macros and Task Manager Pro installed on your XWiki instance
if you wish to migrate Blog posts too, install the Blog Application as well
administrator access to the Confluence instance that you wish to migrate content from or a server XML backup file

Once you have installed the Confluence Migrator Pro, open the prerequisites section and perform the necessary configuration in order to make sure the XWiki instance will support the data migration.

If a prerequisite is met, a checkmark will appear next to its respective line in the dedicated section.

Data migration

Upload export package into XWiki

In order to migrate your data, first attach the Confluence backup file in the dedicated section of the migrator.

Note that if you are using a trial, you will be able to import one space and up to 30 pages per migration. All the other functionalities (prerequisites, import configuration, migration report, simultaneous migrations etc.) are available in the trial version. In order to unlock the full capabilities please obtain a license.

You will be able to attach multiple files and start the data migration from any of them. It is also possible to use a space export. If your Confluence backup fails to upload please make sure that your XWiki instance has enough storage and memory, and also that the attachment limit is not too low. If you are using XWiki in the Cloud, please contact the support team, in order for them to perform the necessary configuration.

Once you have identified the export file that you wish to use, click on "Select package". You will be redirected to the title page, where you can name your migration and configure the import options.

Select export package from server

Alternatively, if the Confluence export packages are placed on a machine that XWiki has access to, please use the "Select an export from server" option:

If you wish to modify the default import configuration, for example, to skip user import or to not preserve history, click on "Advanced migration options". Please see below the documentation on each parameter of the Advanced migration options.

Once you are satisfied with the configuration, click on "Save & View". You will be redirected to the package analyser step. The analysis of the package may take a while if the export is very large.

Once the analysis of the package is done, the list of spaces will appear. You can select all, multiple or one space and search for a space based on their key.

After you have selected all the spaces that you wish to migrate in this run, click on "Confirm". You will be redirected on the import log page. The process of importing and moving the pages into their correct location may take a while if the export is very large.

Finally, when the data migration is done, you will be redirected to the report page, where you will see the pages that have been successfully imported, along with the ones affected by errors.

You will be able to also later review the report by clicking on the migration page in the application's homepage. Moreover, you can run multiple migrations in parallel and see their status.

Advanced migration options

You can fine-tune your migration by configuring the advanced migration options. Please see below the details on each parameter:

Properties of the input filter stream (Confluence XML)

Parameter name	Description	Example value	Default value
Import archived documents	Confluence exports can contain archived documents. XWiki doesn't have a concept of archived document. This parameter lets you optionally import archived documents as regular XWiki documents instead of ignoring them.		FALSE
Import archived spaces.	Confluence exports can contain archived spaces. XWiki doesn't have a concept of archived space. This parameter lets you optionally import archived spaces as regular XWiki spaces instead of ignoring them.		FALSE
Import attachments	If you don't want to import document attachments, set this to false.		TRUE
Base URLs	The list of base URLs leading to the Confluence instance. They are used to convert wrongly entered absolute URLs into wiki links. The first URL in the list will be used to compute page URLs used in the conversion report if the the 'Store Confluence details' property is used. This parameter is used to convert (fix) absolute URLs present as links in the documents that will get imported. The bases of this URLs should be input in this field so that they are converted from the Confluence to the XWiki links. For example, adding in this field www.<myconfluence>.com/wiki/spaces will convert absolute links such as www.<myconfluence>.com/wiki/space/KEY/page into www.<myxwiki>.com/bin/view/KEY/page.		N/A
Blog Space name	This field defines the name of the space under which blog posts will be imported. By default, a "Blog" space will be created under "SPACE KEY".		Blog
Import blog posts	This field decides whether to import blog posts or not. By leaving the default value "true", blog posts will be imported. By changing the value to "false", blog posts will not be imported. Note that if you wish to import blog posts you need to install the Blog Application in XWiki.		TRUE
Cleanup mode	The mode to use for cleaning up temporary files produced when parsing the Confluence package. SYNC: clean up right after the filter stream is done. ASYNC: same, but asynchronously. NO: don't clean up at all		SYNC ASYNC in the Confluence Migrator Pro Application
Produce rendering events for the content	Parse the content to produce rendering events (if the output filter supports them).This is needed in very specific conditions. We do not recommend modifying this parameter unless you know what you are doing.		FALSE
Import contents	This parameter defines whether to import the body and set content of regular documents and blog posts (if blog posts are imported). We do not recommend modifying this parameter.		TRUE
XWiki Conversion	This parameter defines whether to convert user, space and document references from the Confluence names to the XWiki names. This includes user id mapping and group mapping described below, which will not be applicable if this parameter is set to false. The confluence syntax to XWiki syntax This is needed in very specific conditions. We do not recommend modifying this parameter unless you know what you are doing. In particular, XWiki may not be able to render your imported documents and links will probably be broken if you disable this.		TRUE
Default locale	This parameter defines the locale that will be used for the imported documents. Usage example: you have a xwiki instance that you want to be localized with both en and fr. The default locale for your instance is en. You have a Confluence instance that has its content in French. You import from Confluence to XWiki and all the created documents will have their locale set to your xwiki default locale (en) and the content brought from Confluence wwill be in French. Ideally, you set the parameter default locale to "fr" so all the imported documents will have their locale equal to "fr". Now, if you want to also have an English version of the documents, you create it and translate it.	fr	N/A
Page name validation	This parameter defines whether the pages should be validated against and converted using XWiki's current page naming strategy. This works if the XWIKI CONVERSION field is set to "true". This is needed in very specific conditions. We do not recommend modifying this parameter unless you know what you are doing. In particular, XWiki may not be able to render your imported documents and links will probably be broken if you disable this.		TRUE
Excluded pages	List in this field the Confluence pages to ignore from the import. The format is a comma separated list of page IDs where each number is a page id. See also the Ranges and the Included pages parameters.	54,323,412,312,365,400
Group name mapping	This field offers the option to specify a list of A=X relations where A is a Confluence group name and X is an XWiki group name. A will be renamed to X. These sets are separated using the pipe character (\|). If several Confluence groups are mapped to the same XWiki group, the groups will be merged: users of all the Confluence groups will be added to the given XWiki group. For instance, with A=X\|B=X, users in Confluence group A and in Confluence group B will be added to XWiki group X. If X is empty, the group will be discarded. This parameter is used for two things: Group and user imports Permission migration (the Confluence permission applying to Confluence group A will be translated and will apply to XWiki group X). Also note the existence of the "group name prefix" and the "group name sufix" output filter stream parameters that apply on top of this mapping.		system-administrators=XWikiAdminGroup\|site-admins=XWikiAdminGroup\|administrators=XWikiAdminGroup\|users=XWikiAllGroup\|confluence-users=XWikiAllGroup\|_licensed-confluence=\|confluence-administrators=XWikiAdminGroup
Import history	Set this to false if you want to discard previous revisions of documents (for performance, space or import speed concerns)		TRUE
Home redirect	When non nested import is used, home pages are renamed so they can be the home page of spaces in XWiki. If set to true, redirects are output so links to these pages are not broken. When nested import is used, this parameter is ignored.		TRUE
Included pages	This field allows you to specify pages that should be imported. The format is a comma separated list of page IDs where each number is a page id. See also the Ranges and the Excluded pages parameters.	54,323,412,312,365,400
Macro content syntax	This parameter defines the target syntax to be used. This is needed in very specific conditions. We do not recommend modifying this parameter unless you know what you are doing		N/A
Max Page count	if you want to limit the number of imported pages, set this to the desired number. -1 disable any limitation		-1
Nested import	Defines how to handle nested spaces false: use the old XWiki behavior, which also corresponds to how Confluence represents parent relationship between pages. The Nested Pages Migrator Application will be needed to convert this relationship into the current native XWiki way of representing parentship. true: use the new XWiki behavior.		false true in the Confluence Migrator Pro Application. Note: the default will probably be changed to true at some point in the future.
Import non-blog content	This field defines whether to import non-blog contents (normal documents) or not. When this parameter and the IMPORT BLOG POSTS are set to "true", both regular pages and blog posts get imported. Set this parameter to "false" if you wish to import only blog posts present in an export package.		TRUE
Object ID ranges	Ranges of Confluence objects to read. Can be used to restore an interrupted migration. Several comma-separated ranges can be given. Note that the order used for these ranges are not increasingly big ids, but in the order they are processed by the Confluence module. This order may change between versions of the parser, but is guaranteed to be the same between different runs using the same version of the Confluence module. Ranges must not overlap. Overlapping ranges are not supported, may lead to surprising results and their behavior is not guaranteed to be stable. In the same vain, ranges must be ordered in the parsing order.	[4242,] - only read object id 4242 and all the following ones (4242,] - same, but exclude object id 4242 [,4242] - read all objects until object id 4242 included [,4242) - same, but exclude 4242 [4242,2424], [3456,1234] - read objects between 4242 and 2424 both included, then ignore objects until 5656 and read objects between 5656 and 1234 both included (notice how IDs may look disordered)
Prefixed macros	This field stores an allowlist of macros that should be prefixed. A few macros exist both in XWiki and in Confluence under the same name. In order to allow the usage of the bridge macros (dedicated to displaying content in the same manner as it was in Confluence), those macros should be prefixed so that the bridge macros (e.g. "confluence_gallery") are used and not the original XWiki macro (e.g. "gallery"). We do not recommend modifying this parameter.		attachments,gallery,chart
Import rights	This parameter definer whether permissions set in Confluence should be migrated into XWiki. This parameter definer whether permissions set in Confluence should be migrated into XWiki. Importing users and groups is not mandatory; rights will be imported without. However, if you disable user or group import to import them using another method, for the correct rights to apply to the correct users and groups, you will need to create the users and the groups with the exact same names that are in Confluence, or that are specified in the User id mapping and Group name mapping parameters (as these two parameters will be respected by the right migration even if groups and users are not imported).		TRUE
Root space name	If you want content to be put in a specific space instead of at the wiki root, set this to the name of this space	Migrated
Space Home Page	This parameter defines which document name to use for the Confluence space home page. Changing this is needed in very specific conditions. We do not recommend modifying this parameter unless you know what you are doing. Anything else than WebHome could lead to suprising behavior.		WebHome
Title spaces from their home page	Title spaces using the Confluence home page titles instead of the Confluence space names. Home pages in Confluence are usually named something like "Home" or "SPACENAME Home", which is not very helpful. In Confluence, spaces are named and that's usually what you want as the title of spaces in XWiki. However, if you happen to have useful home page titles, you may want to set this to true. Space name are always taken from Confluence space keys regardless what you choose here.		FALSE
Store Confluence details	This parameter specifies whether to store Confluence metadata in migrated documents as objects. This is usually useless, but in some cases, this metadata can be useful for debugging purposes and might end up useful to support CQL-based Confluence macros like spacebylabel or detailssummary in the future.		FALSE
Import tags	Set this to false if you don't want Confluence labels to be migrated to XWiki tags		TRUE
Unknown macro prefix	This field defines the prefix to be used for the macros specified in the "Prefixed macros" field. We do not recommend modifying this parameter.		confluence_
Unprefixed macros	This field stores a denylist of macros that should not be prefixed. We do not recommend modifying this parameter.		N/A
User id mapping	A mapping between Confluence user id located in the package and wanted ids. Similar to GROUP NAME MAPPING, this field stores a list of A=B couples separated with a pipe character (\|) where A is the name of a Confluence user and B is the desired user name in XWiki.	user1=User1\|charliedo=CharlieDo\|ConfluenceAlice=Alice\|ConfluenceBob=Bob
Produce user references	This parameter defines if links to user profiles should be created for existing Confluence user profile links.		FALSE
Import users	Import the users and groups found in the confluence package. If this parameter is set to true, user profiles present in the export package will be imported into XWiki. Setting this parameter to "false" may be needed if you use a central user directory service like LDAP or Active Directory, in which case you need to decide on a careful user migration strategy.		TRUE
Users wiki	The wiki where to import users.If you have a multi wiki environment and you set the Import users to "true", you can specify here the wiki in which users should be created.		N/A (current wiki)
Verbose	This field defines whether to create detailed import logs or not. If you are using the Confluence Migrator Pro Application, we do not recommend modifying this parameter.		TRUE

Properties of the output filter stream (XWiki instance)

VERBOSE
verbose
Default value: "true".

This field defined whether to create detailed import logs or not. We do not recommend modifying this parameter.

SAVE AUTHOR
The author to use when saving documents.
Default value: N/A.

If you wish to have all imported pages last saved by a certain user, specify said user in this field.

GROUP NAME PREFIX
The prefix to add before each new group name.
Default value: N/A.

Specify here a string that will be added as a prefix to newly created or mapped groups, following the data import.

GROUP NAME SUFFIX
The suffix to add after each new group name.
Default value: N/A.

Specify here a string that will be added as a suffix to newly created or mapped groups, following the data import.

SAVE COMMENT
The comment to set when saving a document.
Default value: "Import".

The comment visible on the first version of the imported page. Currently slightly unstable.

PRESERVE VERSION
Indicate if the versions coming from the events should be kept
Default value: "true".

This field defines whether the following metadata of each version is kept: date, creation date, content update date, document version. If IMPORT HISTORY is set to "true" we recommend keeping this parameter "true" as well.

PRESERVE AUTHOR
Indicate if the authors coming from the events should be kept. If false the current user is used.
Default value: "true".

If this field is set to true, the author metadata is imported. If this is set to "false" the current user is used as the author of the imported pages.

DEFAULT REFERENCE
The base reference to use to resolve reference from events
Default value: N/A.

if the input filter provide relative references, this is the reference that will be used to fill the missing parts.

DEFAULT SYNTAX
The default syntax if not is provided in events
Default value: N/A.

XWiki syntax to be used when importing content. We do not recommend modifying this parameter.

DELETE EXISTING DOCUMENT
Indicate if existing document should be deleted before importing the new one.
Default value: "true".

We do not recommend modifying this parameter.

STOP WHEN DOCUMENT SAVE FAIL
Indicate if an exception should be thrown if a document save fail
Default value: "false".

We do not recommend modifying this parameter.

Supported confluence macros

XWiki and Confluence both have their sets of macros, usually used to present content in a particular manner. In order for a macro used in Confluence to display in the same manner in XWiki, the macro has to have the same name and supported parameters. In an effort to make the transition as easy as possible for organisations that migrate from Confluence to XWiki, the Pro Applications team has dedicated significant efforts to creating XWiki macros identical to the most used Confluence macros. These macros are all present in the Pro Macros bundle.

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 Pro Macros package, the content will subsequently be displayed identically to the Confluence counterpart following the update and introduction of said macro in the Pro Macros.

If one or multiple macros are required, the Client may choose to sponsor the development of those macros. Please contact sales@xwiki.com if you would like to inquiry about the development of certain macros.

Macro name	Migration supported	Comments
expand	Yes
details	No	CQL parser required
toc	Yes
jira	Partial	Parameters : server, columns id, columns, jqlQuery, serverId. Depends on the parameters supported.
children	Yes	Basic version of the macro is available. Some parameters are missing.
recently-updated	Yes
anchor	Yes
panel	Yes
view-file	Yes
status	Yes
info	Yes
create-from-template	No	Already included in the standard «Create» wizard of XWiki. Should not be migrated
code	Yes
contentbylabel	No	CQL parser required
include	Yes
tasks-report-macro	Yes
display-footnotes	No
pagetree	Yes
detailssummary	No	CQL parser required
warning	Yes
tip	Yes
note	Yes
attachments	Yes
column	Yes
excerpt-include	Yes
section	Yes
excerpt	Yes
pagetreesearch	No
profile-picture	Partial
contributors	Yes
livesearch	No
roadmap	No
blog-posts	No	Migrate to the Blog application. Complexity depends on the parameters to migrate
noformat	No	Migrate to the Code macro
viewxls	Yes
gliffy	Yes
table-filter	No
ui-expand	No
mathinline	No
calendar	No	Configurable calendar macro. Date macro exists.
change-history	Partial	Same information as the History panel, which is displayed by default in the page. The migration will imply removing the change history macro and using the history tab.
ui-button	No
style	No	Migrate to SSX
jirachart	No	Improvements of the JIRA macro
div	No
gadget	No
navmap	No
widget	No
pivot-table	No
viewppt	Yes
table-chart	No
listlabels	No
scroll-ignore	No
viewpdf	Yes
auitabspage	No
auitabs	No
status-handy	No
jira-key	No	Migration to the XWiki JIRA macro, which is already capable to display the status of a single issue.
content-report-table	Yes
multiexcerpt	No
ui-tab	No
ui-tabs	No
chart	No
table	No
auihorizontalnav	No
plantuml	No
unmigrated-wiki-markup	No
numberedheadings	No
popular-labels	No	Migration to tag cloud
bgcolor	No
table-excerpt-include	No
ui-text-box	No
table-joiner	No	CQL parser required
multiexcerpt-include	No
table-excerpt	No
outgoing-links	No
task-list	Yes	See task-report-macro
userlister	Yes
confluence-advanced-macros	No
footnote	No
viewdoc	Yes
live-template	No
drawio	Yes
pagestatus	No
confluence-information-plugin	No
jira-jqlQuery	No	Migration to the XWiki JIRA macro, which is already capable to execute JQL queries
ui-step	No
ui-steps	No
multimedia	Yes
tasklist	Yes
html	Yes	in some instances macro call is html-macro
survey	No
markdown	No
tooltip	No
spreadsheets	No
gallery	Yes
vote	No
hideelements-macro	No
scroll-exportbutton	No
unmigrated-inline-wiki-markup	No
mathblock	No
scroll-pagebreak	No
toc-zone	No
incoming-links	No
htmlcomment	No
insight-objects-macro	No
linkgraph	No
dbbox	No
report-info	No
report-table	No
timestamp	No
pageapproval	No
scroll-pagetitle	No
scroll-tablelayout	No
auiprogress	No
auiprogressstepstatic	No
get-metadata	No
favpages	No
loremipsum	No
polls	No
add-label	No
contributors-summary	No
profile	Yes
mockup	No
scroll-landscape	No
add-page-form	No
shared-block	No
scroll-imagemap	No
json-from-table	No
add-page	No
lucidchart	No
multivote	No
table-plus	Partial
center	No	Migrate to XWiki syntax.
rw-search	No
scroll-only	No
metadata	No
user-macro	No
tel	No
oitlogo	No
link-to	No
scroll-title	No
jiraissues	No
list-permitted-users-macro	No
workflowreport	No
sharelinks-urlmacro	No
scroll-portrait	No
search	No
unit	No
card	No	Re-use the existing tabs macro
deck	No	Re-use the existing tabs macro
wireframe	No
rss	No
tr	No	Migrate to XWiki syntax
ui-children-cards	No
pagebreak	No
tableplus	No
link-window	No
plantumlrender	No
conditionalcontent	No
auimessage	No
metadata-from	No
flowchart	No
auibutton	No
th	No	Migrate to XWiki syntax
sv-translation	No
topusers	No
include-shared-block-inline	No
questionslist-macro	No
inc-drawio	No
span	No	Macro to generate wiki syntax
globaltimeline	No
include-shared-block	No
discussion-information-box	No
discussion-contributors	No
childtabs	No
discussion-list	No
redirect	No
latex	No
lastmod	No	Equivalent to recently updated macro
portfolio-for-jira-plan	No
usage	No
spaceaccessusersminimal	No
space-attachments	No
countdown	No
recently-updated-dashboard	No	"legacy macro" according to confluence docs, which seems to recommend the "recently updated macro" instead
collapsible-panel	No
join-event	No
join-event	No
playsql-query	No
choose-label	No
english	No
scroll-ignore-inline	No
pocketquery	No
tbd	No
cql-search	No
italian	No
page-info	No
pageactivity	No
img	No	Migrate to XWiki syntax
highlight	No
pagetreecreator-button	No
csv	No
progress-bar	No
index	No
pagetreecreator-default-value	No
csv-table	No
align	No
alert	No
json-table	Partial
mermaid-macro	No
visio	No
button	No
spacegraph	No
talk	No
spaces	No
popular	No
iframe	No	Migrate to XWiki syntax + HTML macro
excel	No
divbox	No	Could be translated to standard wiki syntax
miro	No	Advanced embed : possibility to define how to display Miro drawings
viewfile	Yes
cheese	No
scroll-office-ignore	No
new-anchorpage	No
scroll-content-block	No
related-labels	No
contact-qr-code	No
fancy-bullets	No
auibuttongroup	No
create-page	No
ancestor-labels	No
viedpdf	No
space-breadcrumbs	No
discussion-summary	No
metadata-report	No
discussion-space-contributors	No
space-metadata	No
aui-tab-group	No
handy-tip	No
ptc-template-properties-macro	No
excerpt-includeplus	No
upcoming-events	No
localtab	No
parent-link	No
html-include	No
localtabgroup	No
creation-infos	No
event-calendar	No
content-by-user	No
scroll-pdf-ignore	No
roundrect	No	Migrate to XWiki syntax
pagetreecreator-multi-button	No
pre	No
cloak	No	Re-use the existing show/hide macro
toggle-cloak	No	Re-use the existing show/hide macro
link-page	No
attachment-table	No
talk-report	No
math	No
handy-carousel	No
auidialog	No
spaceaccessusers	No
tabs-group	No
tab-pane	No
document-states-report	No
include-version	No
alias	No
handy-post-organizer	No
horizontal-nav-group	No
horizontal-nav-item	No
nav-group-advanced	No
nav-item-advanced	No
lozenge	No
ui-image	No
google-calendar	No
mathdisplay	No
network	No
ptc-tag-description	No
recently-used-labels	No
tracking-info	No
includeplus	No
plantumlreader	No
spreadsheet-table	No
child-counter	No
version-history	No
space-details	No
scroll-office-only	No
mathblock-ref	No
search-box	No
ptc-template-page-properties-macro	No
priority1	No
rw-users	No
clickable	No
question-answer-list-macro	No
scroll-office-only-inline	No
imagemap	No
checkbox-list	No
confluence-button	No
include-children	No
scroll-pdf-only	No
create-space-button	No
latex-formatting	No
map	No
priority2	No
checkbox	No
german	No
auihorizontalnavpage	No
handy-reminder	No
im	No
markdown-from-url	No
page-status	No
p	No
confluence-open-api	No
database-structure	No
document-stats-report	No
sv-pagetree	No
scroll-only-inline	No
priority3	No
recently-updated-dashboard-category	No
rw-pagetree	No
rw-news	No
navitabs	No
global-reports	No
flowchartrender	No
scroll-bookmark	No
orpheaned-links	No
metadata-values	No
timeline-template	No
zeiterfassung	No
confiform	No
confiform-value	No
ptc-jira	No
listallgroups	No
mugshot-gallery	No
pageapproval-report	No
space-metadata-list	No
metadata-list	No
noprint	No
ui-children	No
pagetitle	No
page-view-macro	No
vertical-nav-group	No
vertical-nav-item	No
sp-infobulle	No
scroll-indexterm	No
scroll-office-index-term	No
scroll-office-ignore-inline	No
workflow-reporter	No
metadata-calculate	No
database-info	No
playsql-chart	No
vbcp-macro	No
confiform-entry-register	No
course-list	No
format-text	No
page-permissions	No
scroll-to-top	No
gatracking	No
space-news	No
rw-users-space	No
rw-favpages	No
spaceadmins	No
childrenbylabel	No
surveydisplay	No
french	No
japanese	No
increment-metadata	No
space-metadata-from	No
metadata-table	No
atlassian	companion
diagramly	No
subpages	No	Equivalent to children macro
wiki-markup	No
rate	No
aui-pages-by-label-tab	No
searchandsortbydate	No
contributor	No
ptc-jira-automation	No
bibtex-display	No
tbody	No
userloginlist	No
space_administrators	No
labeltabs	No
canadian-en	No
lock-content-macro	No
currency-converter	No
view-generic-group-rule-execution-logs	No
view-export-rule-execution-logs	No
handy-post-organizer-content	No
chinese	No
english-us	No
layout	Yes
td	No	Migrate to XWiki syntax
composition-setup	No	Cannot be migrated. Specific to the Composition extension
float	No	Migrate to XWiki syntax
jira-chart	No
banner	No
showcase	No
show-card	No
bibtex-reference	No
getbitbucketadmins	No
getitrackusers	No
jql-table	No
lastupdateddate	No
mathjax-block-macro	No
mathjax-inline-macro	No
monthcalendar	No
prezi	No
privacy-mark	No
rest-table	No
table-enhancer	No
wasdalink	No
database-query-compact	No
csv-export	No
google-map	No
tableenhancer	No
dynamic_checkboxes	No
signature	No
graphity	No
confluence_gallery	No
enhanced-profile	No
umgebungsliste-vvp	No
members-page-disclaimer	No
activeusers	No
mail-form	No
subspaces	No
text-data	No
list-data	No
date-data	No
number-data	No
user-options	No
list-option	No
attachment-data	No
label-options	No
report-column	No
local-reporter	No
text-sort	No
report-empty	No
checklist-wiki	No
checklist-excerpt	No
checklist-label	No
easy-dropdown-menu-predefined	No
easy-dropdown-menu	No
/ shortcut	No
pdfpagebreak	No
odoo-connect	No
forecast	No
popular-pages	No
tagcloud	No	Cloud of Tags XWiki alternative
getcustomername	No
getsalesopportunity	No
getusername	No
unitube	No
requirement	No
requirement-baseline	No
requirement-property	No
requirement-report	No
requirement-report-pages	No
jira-confluence-issue-field-macro	No
jira-confluence-issue-macro	No
chart-plugin	No
hautonumheadmacro	No
listables	No
leanix-widget	No
folder-attachments	No
sa-page-version	No
html-macro	No
cnfl-code-snippet	No
lref-onedrive-embedded-file	No
lref-onedrive-files-list	No
decisionreport	No
lref-onedrive-file	No
simple-qa-export-view	No
simple-qa-overview	No
hover	No
multiexcerpt-macro	No
multiexcerpt-enhanced-permissions	No
multiexcerpt-include-macro	No
markdown-url	No
markdown-attachment	No
css-class	No
css-style	No
marked	No
drawio-sketch	No	Editor with a custom skin
show-if	No
hide-if	No
viewport-redirect	No
viewport-url-redirect	No
viewtracker	No
recently-viewed	No
viewtracker-report	No
mail-input	No
responses-table	No
checkbox-button-group	No
mail-date-picker	No
hide	No
sql-query	No
sql	No
cache	No

Macro name

Migration supported

Comments

expand

Yes

details

CQL parser required

toc

Yes

jira

Partial

Parameters : server, columns id, columns, jqlQuery, serverId. Depends on the parameters supported.

children

Yes

Basic version of the macro is available. Some parameters are missing.

recently-updated

Yes

anchor

Yes

panel

Yes

view-file

Yes

status

Yes

info

Yes

create-from-template

Already included in the standard «Create» wizard of XWiki. Should not be migrated

code

Yes

contentbylabel

CQL parser required

include

Yes

tasks-report-macro

Yes

display-footnotes

pagetree

Yes

detailssummary

CQL parser required

warning

Yes

tip

Yes

note

Yes

attachments

Yes

column

Yes

excerpt-include

Yes

section

Yes

excerpt

Yes

pagetreesearch

profile-picture

Partial

contributors

Yes

livesearch

roadmap

blog-posts

Migrate to the Blog application. Complexity depends on the parameters to migrate

noformat

Migrate to the Code macro

viewxls

Yes

gliffy

Yes

table-filter

ui-expand

mathinline

calendar

Configurable calendar macro. Date macro exists.

change-history

Partial

Same information as the History panel, which is displayed by default in the page. The migration will imply removing the change history macro and using the history tab.

ui-button

style

Migrate to SSX

jirachart

Improvements of the JIRA macro

div

gadget

navmap

widget

pivot-table

viewppt

Yes

table-chart

listlabels

scroll-ignore

viewpdf

Yes

auitabspage

auitabs

status-handy

jira-key

Migration to the XWiki JIRA macro, which is already capable to display the status of a single issue.

content-report-table

Yes

multiexcerpt

ui-tab

ui-tabs

chart

table

auihorizontalnav

plantuml

unmigrated-wiki-markup

numberedheadings

popular-labels

Migration to tag cloud

bgcolor

table-excerpt-include

ui-text-box

table-joiner

CQL parser required

multiexcerpt-include

table-excerpt

outgoing-links

task-list

Yes

See task-report-macro

userlister

Yes

confluence-advanced-macros

footnote

viewdoc

Yes

live-template

drawio

Yes

pagestatus

confluence-information-plugin

jira-jqlQuery

Migration to the XWiki JIRA macro, which is already capable to execute JQL queries

ui-step

ui-steps

multimedia

Yes

tasklist

Yes

html

Yes

in some instances macro call is html-macro

survey

markdown

tooltip

spreadsheets

gallery

Yes

vote

hideelements-macro

scroll-exportbutton

unmigrated-inline-wiki-markup

mathblock

scroll-pagebreak

toc-zone

incoming-links

htmlcomment

insight-objects-macro

linkgraph

dbbox

report-info

report-table

timestamp

pageapproval

scroll-pagetitle

scroll-tablelayout

auiprogress

auiprogressstepstatic

get-metadata

favpages

loremipsum

polls

add-label

contributors-summary

profile

Yes

mockup

scroll-landscape

add-page-form

shared-block

scroll-imagemap

json-from-table

add-page

lucidchart

multivote

table-plus

Partial

center

Migrate to XWiki syntax.

rw-search

scroll-only

metadata

user-macro

tel

oitlogo

link-to

scroll-title

jiraissues

list-permitted-users-macro

workflowreport

sharelinks-urlmacro

scroll-portrait

unit

card

Re-use the existing tabs macro

deck

Re-use the existing tabs macro

wireframe

rss

Migrate to XWiki syntax

ui-children-cards

pagebreak

tableplus

link-window

plantumlrender

conditionalcontent

auimessage

metadata-from

flowchart

auibutton

Migrate to XWiki syntax

sv-translation

topusers

include-shared-block-inline

questionslist-macro

inc-drawio

span

Macro to generate wiki syntax

globaltimeline

include-shared-block

discussion-information-box

discussion-contributors

childtabs

discussion-list

redirect

latex

lastmod

Equivalent to recently updated macro

portfolio-for-jira-plan

usage

spaceaccessusersminimal

space-attachments

countdown

recently-updated-dashboard

"legacy macro" according to confluence docs, which seems to recommend the "recently updated macro" instead

collapsible-panel

join-event

playsql-query

choose-label

english

scroll-ignore-inline

pocketquery

tbd

cql-search

italian

page-info

pageactivity

img

Migrate to XWiki syntax

highlight

pagetreecreator-button

csv

progress-bar

index

pagetreecreator-default-value

csv-table

align

alert

json-table

Partial

mermaid-macro

visio

button

spacegraph

talk

spaces

popular

iframe

Migrate to XWiki syntax + HTML macro

excel

divbox

Could be translated to standard wiki syntax

miro

Advanced embed : possibility to define how to display Miro drawings

viewfile

Yes

cheese

scroll-office-ignore

new-anchorpage

scroll-content-block

related-labels

contact-qr-code

fancy-bullets

auibuttongroup

create-page

ancestor-labels

viedpdf

space-breadcrumbs

discussion-summary

metadata-report

discussion-space-contributors

space-metadata

aui-tab-group

handy-tip

ptc-template-properties-macro

excerpt-includeplus

upcoming-events

localtab

parent-link

html-include

localtabgroup

creation-infos

event-calendar

content-by-user

scroll-pdf-ignore

roundrect

Migrate to XWiki syntax

pagetreecreator-multi-button

pre

cloak

Re-use the existing show/hide macro

toggle-cloak

Re-use the existing show/hide macro

link-page

attachment-table

talk-report

math

handy-carousel

auidialog

spaceaccessusers

tabs-group

tab-pane

document-states-report

include-version

alias

handy-post-organizer

horizontal-nav-group

horizontal-nav-item

nav-group-advanced

nav-item-advanced

lozenge

ui-image

google-calendar

mathdisplay

network

ptc-tag-description

recently-used-labels

tracking-info

includeplus

plantumlreader

spreadsheet-table

child-counter

version-history

space-details

scroll-office-only

mathblock-ref

search-box

ptc-template-page-properties-macro

priority1

rw-users

clickable

question-answer-list-macro

scroll-office-only-inline

imagemap

checkbox-list

confluence-button

include-children

scroll-pdf-only

create-space-button

latex-formatting

map

priority2

checkbox

german

auihorizontalnavpage

handy-reminder

markdown-from-url

page-status

confluence-open-api

database-structure

document-stats-report

sv-pagetree

scroll-only-inline

priority3

recently-updated-dashboard-category

rw-pagetree

rw-news

navitabs

global-reports

flowchartrender

scroll-bookmark

orpheaned-links

metadata-values

timeline-template

zeiterfassung

confiform

confiform-value

ptc-jira

listallgroups

mugshot-gallery

pageapproval-report

space-metadata-list

metadata-list

noprint

ui-children

pagetitle

page-view-macro

vertical-nav-group

vertical-nav-item

sp-infobulle

scroll-indexterm

scroll-office-index-term

scroll-office-ignore-inline

workflow-reporter

metadata-calculate

database-info

playsql-chart

vbcp-macro

confiform-entry-register

course-list

format-text

page-permissions

scroll-to-top

gatracking

space-news

rw-users-space

rw-favpages

spaceadmins

childrenbylabel

surveydisplay

french

japanese

increment-metadata

space-metadata-from

metadata-table

atlassian

companion

diagramly

subpages

Equivalent to children macro

wiki-markup

rate

aui-pages-by-label-tab

searchandsortbydate

contributor

ptc-jira-automation

bibtex-display

tbody

userloginlist

space_administrators

labeltabs

canadian-en

lock-content-macro

currency-converter

view-generic-group-rule-execution-logs

view-export-rule-execution-logs

handy-post-organizer-content

chinese

english-us

layout

Yes

Migrate to XWiki syntax

composition-setup

Cannot be migrated. Specific to the Composition extension

float

Migrate to XWiki syntax

jira-chart

banner

showcase

show-card

bibtex-reference

getbitbucketadmins

getitrackusers

jql-table

lastupdateddate

mathjax-block-macro

mathjax-inline-macro

monthcalendar

prezi

privacy-mark

rest-table

table-enhancer

wasdalink

database-query-compact

csv-export

google-map

tableenhancer

dynamic_checkboxes

signature

graphity

confluence_gallery

enhanced-profile

umgebungsliste-vvp

members-page-disclaimer

activeusers

mail-form

subspaces

text-data

list-data

date-data

number-data

user-options

list-option

attachment-data

label-options

report-column

local-reporter

text-sort

report-empty

checklist-wiki

checklist-excerpt

checklist-label

easy-dropdown-menu-predefined

easy-dropdown-menu

/ shortcut

pdfpagebreak

odoo-connect

forecast

popular-pages

Installation Steps

This paid extensions requires false or above. In order to install the extension, follow the next steps inside your XWiki instance (on cloud or on premise).

Navigate to the Extension Manager

In the Applications Panel click on "More Applications..." and then "Install new applications...". Alternatively navigate directly to the Administration and select the "Extensions" section.

Install the Extension

Search for the extension you wish to install and use the Install button to install it.

Get a License

Navigate to the "Licenses" section of the Administration, fill your details, look for the extension you just installed in the live table and click the buttons to get a trial license or to buy a license.

Install the License

If you have selected a trial license then you're good and there's nothing else to do. Your trial license is automatically installed.

However if you've selected to buy a license you'll be redirected to a page to perform the payment. At the end you need to come back to the "Licenses" administration section and click on the "Check for Updates" button. This will download and apply the license you bought.

Use the Extension

Start using the Extension! Refer to the extension's documentation to know how to use it.

Installing Paid Apps on Subwikis

If you want to install an application on the whole farm (main wiki + subwikis), you can do so directly from the main wiki’s Extension Manager, as seen below:

Extensions can also be installed only on a particular subwiki by global admins. Subwiki admins will not be able to install these extensions due to their limited rights.

Options

The price is per year and varies depending on the support level and the number of users.

Support / Users	Unlimited
Gold	2000

Benefits

What do you get when you purchase an XWiki extension?

1 year license

By purchasing an XWiki extension license, you'll benefit from it during one year.

Free updates

You benefit from all the extension updates during one year. You are always up to date.

Support included

If you are facing an issue, you can reach the XWiki support. Our team is always available to help.

How to Buy

To buy, install this extension from inside your XWiki instance and follow the instructions.

Release notes

v1.19.1

#129: Selecting a package fails because of a cast error (introduced in 1.19.0)

v1.19.0

#126: Skip the space selection screen when there is only one space in the Confluence package
#127: Reports can't show migrated spaces when the space question screen was skipped
#128: Allow leaving out file:// when specifying a server path as a source package

v1.18.0

#125: Convert pagetreesearch to locationSearch

v1.17.0

#123: Convert livesearch macros into search location macros

v1.16.2

Fixes:

#122: The state of migrations which died is misrepresented in the migration list and on the report page

Update dependency on the Confluence XML package to version 9.47.0, which starts supporting exports from Confluence 8.X.

v1.16.1

#89: Stack traces are on one single line in job logs
#90: Stack traces from job logs are hard to copy paste
#120: Huge logs are causing out of memory (heap space) exceptions in migration pages

v1.16.0

#119: Store huge json objects in attachments instead of object fields in MigrationClass

v1.15.0

Fixes:

#99: Don't depend on Pro Macro's expand macro
#70: Get rid of the nested page migrator
#116: Incorrect naming of the brokenLinksPages property in MigrationClass breaks XAR import and exports of migration pages
#118: The Confluence page id of page affected by broken links is sometimes given instead a friendly link to the imported page
#117: Incorrectly resolved documents make it looks like pages where imported into the ConfluenceMigratorPro space

Update dependency on the Confluence XML package to version 9.46.0, which tries to import pages even when they contain a bad revision.

v1.14.1

Update dependency on the Confluence XML package to version 9.45.0, which fixes group rights issues due to spaces being converted to underscores in group names.

v1.14.0

New features:

#53: Add the ability to interrupt a migration
#108: Sort migrations by creation date (most recent first)

Fixes:

#45: Green "Migration complete" message shown when clicking on cancel
#101: Migrations restart when an exception is thrown in the Confluence Migrator Pro code

Update dependency on the Confluence XML package to version 9.44.0, which fix a view right propagation issue.

v1.13.2

Update dependency on the Confluence XML package to version 9.43.0, which fix a view right propagation issue.

v1.13.1

#111: Ignore events related to migrations not started with Confluence Migrator Pro
#110: Errors should be qualified critical
#109: The "non-critical" qualification of issues is unfortunate
#112: Support page ids in link mappings

Update dependency on the Confluence XML package to version 9.42.0, which fix a view right propagation issue.

v1.13.0

Update dependency on the Confluence XML package to version 9.41.0, which fix a view right propagation issue.

v1.12.1

#106: Link Mapping is updated when option " Use saved link mapping", not "Update link mapping", is checked

v1.12.0

#103: Rights-only migration triggers an exception which restarts the migration
#104: Log contents are interpreted as XWiki syntax
#105: Use link mapping to avoid broken links with space exports
#100: Pro Macros marked as unsupported when they actually are

Update dependency on the Confluence XML package to version 9.40.0.

v1.11.14

#66: Hide the "Not supported macros" section if there are none

v1.11.13

#98: Class cast exception causing infinite migration restarts

v1.11.12

Update dependency on the Confluence XML package to version 9.39.3.

v1.11.11

Fixes:

#97: Broken link table is displayed as raw HTML
#95: NPE during some migration because of null log marker
#96: Space names are incorrectly escaped in the report

v1.11.10

#87: Dedicate a section to broken link warnings
#94: Visiting a migrated space from the migration report is not easy
#93: Missing object only output filter stream descriptor
#85: Space selection search usually finds nothing when upper case characters are typed
#63: Add detailed description for the "GROUP NAME MAPPING" field on Advanced Migration Options

Update dependency on the Confluence XML package to version 9.39.2.

This release is unusable, please upgrade to the next.

v1.11.9

Fixes:

#80: Group name prefix and Group name suffix output stream parameters don't work
#82: Add children to the macros prefixed by default
#83: Hide the output filter stream parameters from the UI

Update dependency on the Confluence XML package to version 9.39.1.

v1.11.8

Update dependency on the Confluence XML package to version 9.39.0.

v1.11.7

Update dependency on the Confluence XML package to version 9.38.2.

v1.11.6

Update dependency on the Confluence XML package to version 9.37.1.

v1.11.5

Fixes:

#79:The wrong document tree is shown in the migration report when using the root space feature

v1.11.4

Update dependency on the Confluence XML package to version 9.37.0.

Improvements:

#65: Allow cleaning group pages names when migrating confluence rights

Fixes:

#78: MigrationClass uses wiki syntax and WYSISWG for fields storing JSON

v1.11.3

Update dependency on the Confluence XML package to version 9.36.2.

Improvements:

#73: Display warning and error counts Type: New Feature
#74: Display dates in the migration job log after it finished
#77: Display the imported document count

Fixes:

#76: Don't make the users wait for the package to be cleaned up
#75: When prefilling configuration from a previous migration, package selection is ignored

v1.11.2

Improvements:

#72 Upgrade Licensor dependency to version 1.25

v1.11.1

Update dependency on the Confluence XML package to version 9.36.1.

Improvements:

#71 Don't wait for the Solr queue to be empty when not using NPMIG

v1.11.0

Update dependency on the Confluence XML package to version 9.35.1 allowing:

New features:

#69 Directly import as nested spaces instead of using the nested page migrator by default

Bug fixes:

#37 Add the option to overwrite pages
#50 Page modification dates are not correctly migrated into XWiki
#54 No logs during user import
#62 Import Confluence regular pages as children of root spaces
#68 WebPreferences document is visible after import

This is an important release that changes three important things (besides various improvements):

The nested page migration ("conversion") step is now skipped by default. Pages are now directly nested. This should provide important performance improvements.
The root pages of imported spaces are now the home Confluence page, and not the space description as it was until now. The space description was often empty, leading to a confusing state where the root of spaces was an empty page and then under it the home page, and then under the home page, regular pages.
You can now create a migration from a given document, effectively letting you "restart" a migration, using the "object id range" property.

v1.10.0

New feature:

#32 As part of the migration report of a Confluence package, list the Confluence macros that are missing in XWiki

Update dependency on the Confluence XML package to version 9.34.1

v1.9.4

Bugs fixed:

#61 Selecting a package from the server is only possible when migrations have already been done

v1.9.3

New feature:

#60 Selecting a package from the server is only possible when migrations have already been done

Update dependency on the Confluence XML package to version 9.33.1

v1.9.2

Update dependency on the Confluence XML package to version 9.33.0.

v1.9.1

Bugs fixed:

#57 NPE when a page title is missing (crash)

v1.9

New feature:

#56 Add an option to skip questions

Update dependency on the Confluence XML package to version 9.32.0.

v1.8.3

Bugs fixed:

#24 The imported pages list is reported as empty when migrating on a subwiki
#47 Missing history comments

v1.8.2

Update dependency on the Confluence XML package to version 9.31.3

v1.8.1

Update dependency on the Confluence XML package to version 9.31.1

v1.8.0

Update dependency on the Confluence XML package to version 9.31.0, which disable migration of archived space by default, and provides parameters to enable migration of archived spaces and documents.

v1.7.9

Update dependency on the Confluence XML package to version 9.29.6, which improves performance of the step right after creating a migration and before the space selection a lot.

v1.7.8

Update dependency on the Nested Page Migrator to version 0.10.1

v1.7.7

Update dependency on the Confluence XML package to version 9.29.5

v1.7.6

Update dependency on the Confluence XML package to version 9.29.3

v1.7.5

Update dependency on the Confluence XML package to version 9.29.2
Fix #41

v1.7.4

Dependency upgrades: Confluence XML package to version 9.29.1 and Licensor to version 1.24.4.

v1.7.3

Fix:

#42: Javascript error about XWiki.FileUploader not being defined on migration pages
#44: Input and output filter stream parameters are not always respected

Improvements:

#28: Remove SORL queue line in prerequisites and make the process automatic
#33: Automate listener deactivation when a migration starts

Tasks:

#34: Remove notifications prerequisites

v1.7.2

Fix:

#35 Output filter property "Preserve version" is incorrectly set to false by default

v1.7.1

Fix:

Update dependency on the Nested Page Migrator application to version 0.10.0, fixing some issues related to spaces not being migrated at the right place (see https://jira.xwiki.org/projects/NPMIG/issues/NPMIG-69)

v1.7.0

Improvements:

#26 Add the option to specify path to the Confluence export in the server

Tasks:

#27 Rename Step 2 in "Choose an export package"

v1.6.0

Improvements:

#17 Maintain image width and height set in Confluence

Uses version 9.29.0 of Confluence XML

Tasks:

#29 Upgrade Licensor dependency to version 1.24.3

v1.5.0

Improvements:

Uses version 9.28.0 of Confluence XML

v1.4.0

Improvements:

Uses version 9.27.0 of Confluence XML

v1.3.0

Improvements:

Uses version 9.26.0 of Confluence XML

v1.2.0

Bugs fixed:

#25 Space selection does not filter out blogs from other spaces #25

Improvements:

Uses version 9.25.0 of Confluence XML which supports blog-only migrations and adf extensions (the note macro)

v1.1.0

Bugs fixed:

#18 Cannot use the migrator on subwikis

Improvements:

#20 Support permissions migration

Tasks:

#19 Support Blog Posts migration

v1.0.1

Bugs fixed:

#14 The pro migrator is not working for free licenses
#15 The license manager fails to initialize after the Confluence Migrator Pro is installed and XWiki is restarted

v1.0

First version of the application containing the following functionalities:

homepage with prerequisites, backup packages and reports on previous migrations,
multi space migration,
run multiple migration simultaneously
import configuration
detailed report showing the pages imported successfully, along with the ones affected by errors