Document

The Confluence page from which to transclude content. As this field is mandatory you have to enter the page from which to transclude content. In the case of transcluding content from the current page combined with a theme like the ones provided by Brikit Theme Press for Confluence you can use @self as the name of the page to indicate that the content shall be transcluded from the page that uses this layout.

Identifiers

The identifiers of marked content or sections to include.

Usually only one identifier is used to include one content, but it need not to be only one.

Tags

The tags of marked content or sections to include. Multiple elements are added in the order they appear in their document.

Apply Document Properties

If Apply Document Properties is checked properties of the document and space are applied as placeholders.

Transitive Transclusion

If Transitive Transclusion is checked then transclusion from transcluded content is allowed.

Otherwise the transclusion macros only have access to fragments that are physically part of the document.

Select

Specify a comma-separated list of page properties from the transcluded document to be rendered in a table. You may also specify section names.

Audience->Group=Group Name

Force Show

If checked then content that is hidden in its original location is shown.

This effectively overrides the hide parameter of a Section Macro or Content Marker Macro.

Render Reference Box

If checked, a box that marks the transcluded text is rendered with a link to the part in the document (if the transcluded part is uniquely identifiable).

Here is an example of transcluded content from an example page named "A Document":

If you click on the name you jump to the document of the transcluded content.

A transclusion box is a handle, typically only available to users who actually have write access to a page, to quickly jump to the page from which content is transcluded.

The rendering can be controlled via space property render-transclusion-box.

The following values are valid:

only-with-edit-permission

The reference box is only rendered, if the user has edit permission. That is the user is an other and benefits from the clue of transcluded content.

never

The reference box is never rendered. This may proof useful for authors that want to check the appearance without boxes.

Extract Short Description

If the transclusion renders properties of the transcluded document (see Select), the state of this checkbox controls the rendering of the Short Description property. If checked the short description is rendered on top of the table showing the properties. If unchecked the description is rendered as a key/value property in the properties table.

No Cache

If checked the macro will not use the page fragment cache to calculate the transcluded page fragment.

This does only apply if the space is using the transclusion cache. Otherwise the state of the checkbox has no effect.

If the macro uses placeholders, caching will automatically switched off.

Heading Link

If checked renders heading as link to the document.

If no heading is rendered, this flag has no effect.

Add Link

If specified renders the label as link to the document.

The link is rendered after the possibly extracted short description and in front of the properties table.

Identifier Classes

Apply identifier classes to render this macro as part of a group.

This identifier is used for Remote Control and Context Controlled Macros. Multiple macros on a page may have only one unique Identifier, but may share common identifier classes.

Context controlled

When checked configures parameters via document and space properties.

For more information please refer to Context Controlled Macros.

Remote Controls

docs:select=Name,Type&docs:render-mode=definition