Add Page

Add Page

Description

This macro creates a link on your page, which is similar to the Create Page button on the page operations bar.

Notes about migration

  • Some legacy Macro parameters from the Confluence Server are not supported yet. More details are on our FAQ page.

  • Server users migrating to the Cloud will not lose any data.

  • Live Template created using Linking for Confluence macro needs to be migrated to retain Scaffolding data. The source page and template have to be present in the Cloud. For more information, check here.

  • While functionality is the same, Prefix and” It uses a Scaffolding Forms & Templates's Live Template macro to import and execute the current value of the template every time the page is viewed.

Name

Required

Migratable to cloud

Default value

Description

Name

Required

Migratable to cloud

Default value

Description

Name

(X)

 

YES

 

 

The name of the new page.

Link Text

(V)

YES

 

Text display for the link.

Source

(X)

YES

 

The name of the template or page that is the source of the new page body content. 

Source Type

(X)

YES

template

The type of page source that is being used.  

Live Template

(X)

YES

false

If set to true, the template will be a Scaffolding live template. It uses a Scaffolding Forms & Templates's Live Template macro to import and execute the current value of the template every time the page is viewed.

Requires Scaffolding Forms & Templates to be installed. 

Prefix

(X)

 

PARTIAL

 

 

The injectable prefix to apply to the page name.

For example:

%page:title% - adds the current page title plus - to the start of the page name. 

 Injections are not supported in cloud.

If the Allow Rename parameter is disabled, the user cannot modify this section of the name while creating the page. 

Postfix

(X)

 

PARTIAL

 

 

The injectable postfix to apply to the page name.

For example:

%page:title% - adds the current page title plus  -  to the end of the page name. 

 Injections are not supported in cloud.

 If the Allow Rename parameter is disabled, the user cannot modify this section of the name while creating the page. 

Parent

(X)

 

YES

 

@self

The page you want to be the parent of the new page.

If you don’t want a parent page, set the parameter to a blank value.

Otherwise, set it to <Page name> or <SPACEKEY: Page name>.

There are also three special values:

  •  

@self - sets the parent to the new page the macro appears in.

  •  

@parent - sets the new page's parent to the current page's parent.

  •  

@home - sets the new page's parent to the current space's home page.

Labels

(X)

 

YES

 

 

The list of labels to attach to the new page.

Tip

(X)

 

NO

 

 

A pop-up text that appears when the mouse hovers over the link.

Allow Rename

(X)

 

NO

 

true

If set to true, the user can rename the page while creating it, even if a prefix or postfix is provided.

Editor view

add_page_macro.png

Macro edit view

add_page_macro_editor.png

 

Example use cases