Link Page

Description

This macro is currently not available on Cloud.

Macros will be migrated along with the page, and no data will be lost after migration. On Cloud, macros are hidden in View mode, but are visible in Edit mode where they are marked as (Legacy). More details are available on this page -  FAQ on Confluence Server Linking to Confluence Cloud migration.

This will create a link to a page, or a link to create a page based on a template and/or parent page.

If the page doesn't exist or is untitled, it generates an Add Page link which, when clicked, can take the user directly to a template and/or set the page parent.

The page name may also contain substitution markers, indicated with "%" surrounding a Suppliers for Reporting key chain value.

e.g:

%content:title% - %global:current user > user:full name%

This will link to a page with the name being the parent page's title, followed by " - " followed by the current user's name.


Parameters

NameRequiredAvailable InMigratable to Cloud?Default ValueDescription
Page Name
 Optional
Server, Data Center
No
{injected} The name of the specific page to link to. If not provided, the link will always create a new page when clicked.
Link Text
 Yes
Server, Data Center
No
Text display for the link.
Source
 Optional
Server, Data Center
No
The name of the template or page to copy the new page content from.
Source Type
 Optional
Server, Data Center
No
template
The type of source, either template or page.
Live Template
 Optional
Server, Data Center
No
false
If set to true, the template will be live when the page is created. Requires Scaffolding Forms & Templates to be installed.
Prefix
 Optional
Server, Data Center
No

{injected} The %injectable% prefix to apply to the page name.

The user will not be able to modify this section of the name while creating it.

e.g:

'%page:title% - ' will add the current page title plus ' - ' to the start of the page name. 


Postfix
 Optional
Server, Data Center
No

{injected} The %injectable% postfix to apply to the page name.

The user will not be able to modify this section of the name while creating it.

e.g:

' - %page:title%' will add ' - ' plus the current page title to the end of the page name. 


Parent
 Optional
Server, Data Center
No
@self

The name of the parent page. If no parent page is desired, set parent to a blank value.

May also have the following markers:

  • @self - (default) the parent will be the page the macro is in.
  • @parent - the parent will be the parent of the page the macro is in.
  • @home - the parent will be home page for the Space the page is in. 
Labels
 Optional
Server, Data Center
No
The list of labels to apply to the new page.
Tip
 Optional
Server, Data Center
No
If you want popup text to appear when the mouse is hovered over the link, enter it here.
Allow Rename
 Optional
Server, Data Center
No
If set to true, the user will be allowed to rename the page when it is being created.

Solutions
Apps

Resources
Company