Skip to Content


Archive

Last modified by Raphaël Jakse on 2026/04/09 15:28

The following Confluence bridges are not used anymore during new migrations (the corresponding macros are now directly converted to native XWiki macros), but were used previously.

Anchor

Legacy bridge macro for the Confluence "anchor" macro. The "anchor" macro gets converted into XWiki's native "id" macro upon migration. XWiki's native "id" macro must be used following migration. 

Parameters

ParameterDefaultDescription in ConfluenceParameter supported in XWiki?Comments
Anchor NameNone

This is the anchor name that you will use when creating the link.

  • The anchor name can include spaces. Confluence will remove the spaces automatically when building a URL that points to this anchor.
  • The anchor name is case sensitive. You must use the same pattern of upper and lower case letters when creating the link as you used when creating the Anchor macro.
yesid macro must be used 

old Attachments table (for children?)

ParameterDefaultDescription in ConfluenceParameter supported in XWiki?Comments
Show Descendants
(all) 		false

Choose whether to display all the parent page's descendants.

If true shows the complete tree of pages underneath the parent page, regardless of Depth of Descendants

nopagetree macro can be used to limit the number of pages displayed. 
Parent Page
(page) 		current

Specify the page to display children for, from either the current space or a different space. Enter:

  • '/' — to list the top-level pages of the current space, i.e. those without parents.
  • 'pagename' — to list the children of the specified page.
  • 'spacekey:' — to list the top-level pages of the specified space.
  • 'spacekey:pagename' — to list the children of the specified page in the specified space.
yesPage picker implemented in XWiki's pagetree macro.
Number of Children
(first) 		none

Restrict the number of child pages that are displayed at the top level.

Your administrator may enforce a maximum number for this parameter.

yesMapped to limit parameter from pagetree macro.
Depth of Descendants
(depth) 		none

Enter a number to specify the depth of descendants to display. For example, if the value is 2, the macro will display 2 levels of child pages.

This setting has no effect if Show Descendants is enabled.

Your administrator may enforce a maximum number for this parameter.

yes 
Heading Style
(style) 		noneChoose the style used to display descendants.noSome display options available in pagetree macro but not in the Confluence bridge children macro.
Include Excerpts
(excerpt) 		none

Allows you to include a short excerpt under each page in the list. Choose between:

  • None - no excerpt will be displayed
  • Simple - displays the first line of text contained in an Excerpt macro on any of the returned pages. If there is not an Excerpt macro on the page, nothing will be shown.
  • Rich content - displays the contents of an Excerpt macro, or if there is not an Excerpt macro on the page, the first part of the page content including formatted text, images, and some macros.

Note that your administrator may have set this parameter to none for it to apply to the whole site.

no 
Sort Children By
(sort) 		Manual if manually ordered, otherwise alphabetical

Leave blank to display pages in the order they currently appear in the page tree. Alternatively, choose:

  • creation — to sort by content creation date
  • title — to sort alphabetically on title
  • modified — to sort of last modification date.
noDefault alphabetical ordering applied.
Reverse Sort
(reverse) 		falseUse with the Sort Children By parameter. When set, the sort order changes from ascending to descending.no 

Children

Children bridge macro implemented reusing the documentTree XWiki native feature. Pagetree or children native XWiki macros should be used post migration. 

The Confluence Children macro is automatically converted into XWiki's "children" or "documentTree" macros, depending on parameters. Confluence_children is maintained for compatibility reasons. 

Parameters

ParameterDefaultDescription in ConfluenceParameter supported in XWiki?Comments
Show Descendants
(all) 		false

Choose whether to display all the parent page's descendants.

If true shows the complete tree of pages underneath the parent page, regardless of Depth of Descendants

nopagetree macro can be used to limit the number of pages displayed. 
Parent Page
(page) 		current

Specify the page to display children for, from either the current space or a different space. Enter:

  • '/' — to list the top-level pages of the current space, i.e. those without parents.
  • 'pagename' — to list the children of the specified page.
  • 'spacekey:' — to list the top-level pages of the specified space.
  • 'spacekey:pagename' — to list the children of the specified page in the specified space.
yesPage picker implemented in XWiki's pagetree macro.
Number of Children
(first) 		none

Restrict the number of child pages that are displayed at the top level.

Your administrator may enforce a maximum number for this parameter.

yesMapped to limit parameter from pagetree macro.
Depth of Descendants
(depth) 		none

Enter a number to specify the depth of descendants to display. For example, if the value is 2, the macro will display 2 levels of child pages.

This setting has no effect if Show Descendants is enabled.

Your administrator may enforce a maximum number for this parameter.

yes 
Heading Style
(style) 		noneChoose the style used to display descendants.noSome display options available in pagetree macro but not in the Confluence bridge children macro.
Include Excerpts
(excerpt) 		none

Allows you to include a short excerpt under each page in the list. Choose between:

  • None - no excerpt will be displayed
  • Simple - displays the first line of text contained in an Excerpt macro on any of the returned pages. If there is not an Excerpt macro on the page, nothing will be shown.
  • Rich content - displays the contents of an Excerpt macro, or if there is not an Excerpt macro on the page, the first part of the page content including formatted text, images, and some macros.

Note that your administrator may have set this parameter to none for it to apply to the whole site.

no 
Sort Children By
(sort) 		Manual if manually ordered, otherwise alphabetical

Leave blank to display pages in the order they currently appear in the page tree. Alternatively, choose:

  • creation — to sort by content creation date
  • title — to sort alphabetically on title
  • modified — to sort of last modification date.
noDefault alphabetical ordering applied.
Reverse Sort
(reverse) 		falseUse with the Sort Children By parameter. When set, the sort order changes from ascending to descending.no 

Example

Show all children of the current page:

{{confluence_children/}}

confluence_children-1.png

Show first 5 children of a specified page: 

{{confluence_children page="TEST.WebHome" first="5"/}}

confluence-children-2.png

Info, Tip, Note, Warning

Info

Info: same name as XWiki's "info". XWiki native "info" macro will be used post migration. 

Parameters in Confluence

ParameterDefaultDescription in ConfluenceParameter supported in XWiki?Comments
Optional Title
(title) 		noneThe title of the box. If specified, the title text will be displayed in bold next to the icon.yestitle parameter from XWiki's info macro
Show information/tip/Exclamation Mark/Warning Icon
(icon) 		trueIf "false", the icon will not be displayed.no 

Tip

Tip: bridge for Confluence tip to XWiki's success macro. XWiki native "success" macro should be used post migration. 

Parameters in Confluence

ParameterDefaultDescription in ConfluenceParameter supported in XWiki?Comments
Optional Title
(title) 		noneThe title of the box. If specified, the title text will be displayed in bold next to the icon.yestitle parameter from XWiki's success macro
Show information/tip/Exclamation Mark/Warning Icon
(icon) 		trueIf "false", the icon will not be displayed.no 

Note

Note: bridge for Confluence tip to XWiki's warning maccro. XWiki native "warning" macro should be used post migration. 

Parameters in Confluence

ParameterDefaultDescription in ConfluenceParameter supported in XWiki?Comments
Optional Title
(title) 		noneThe title of the box. If specified, the title text will be displayed in bold next to the icon.yestitle parameter from XWiki's warning macro
Show information/tip/Exclamation Mark/Warning Icon
(icon) 		trueIf "false", the icon will not be displayed.no 

Warning

Warning: same name as XWiki's warning macro. XWiki native "warning" macro will be used post migration. 

Parameters in Confluence

ParameterDefaultDescription in ConfluenceParameter supported in XWiki?Comments
Optional Title
(title) 		noneThe title of the box. If specified, the title text will be displayed in bold next to the icon.yestitle parameter from XWiki's warning macro
Show information/tip/Exclamation Mark/Warning Icon
(icon) 		trueIf "false", the icon will not be displayed.no 

Mathblock

Add a block math expression. Bridges the mathblock Confluence macro using the XWiki's Mathjax macro.

ParameterDescriptionMandatory?Default value
anchorThe anchor to make a reference to this math expressionNoEmpty

Note: the alignment parameter is not yet supported.

Usage example

{{confluence_mathblock anchor="myanchor"}}
2+\frac 1 2 x
{{/confluence_mathblock}}

This block can be referenced like in the following sentence. Expression {{mathblock-ref anchor="myanchor"/}} shows some random and non-sensitical math.

MathBlock-ref

Add a reference to a block math expression. Bridges the mathblock-ref Confluence macro using the XWiki's Mathjax macro.

ParameterDescriptionMandatory?
anchorThe anchor of the math expression to reference.Yes

Usage example

{{confluence_mathblock anchor="myanchor"}}
2+\frac 1 2 x
{{/confluence_mathblock}}

This block can be referenced like in the following sentence. Expression {{mathblock-ref anchor="myanchor"/}} shows some random and non-sensitical math.

Mathinline

Add an inline math expression. Bridges the mathinline Confluence macro using the XWiki's Mathjax macro.

ParameterDescriptionMandatory?
bodyThe math expression. It can start with --uriencoded--, in which case the math expression needs to be url-encoded.Yes

Usage example

The answer is {{confluence_mathinline body="--uriencoded--\sqrt%7B2+x%5e3%7D=\cfrac%7B1%7D%7Ba_1%7D"/}}

PageTree

This macro is a bridge for the Confluence Page Tree macro. It displays the list of pages under the specified page using the Document Tree Macro.

Parameters

ParameterDescriptionAccepted valuesDefault valueMandatory
rootThe space to show.@home (list the pages under the home page of the space), @self (under this page), @none (all the pages of the space), @parent (all the pages in the parent space), or the name of a space@homeNo

Example of usage

{{confluence_pagetree root="Main" /}}

PageTree Search

Converted into search location macro upon import. XWiki native Search Location should be used post migration.  

Parameters in Confluence

ParameterDefaultDescription in ConfluenceParameter supported in XWiki?
Name of Root Page
(root) 		none

The name of the root page whose hierarchy of pages will be searched by this macro. If this not specified, the root page is the current page.

Note: Unlike the Page Tree macro, the Page Tree Search macro does not accept the special values that start with an @ sign, such as @home or @self.

yes