Description

Creates a simple form on a page for users to enter the name of the new page to add.

Very similar to the Add Page macro, this will then create a new page, which may be based on a template if so desired.

Notes about migration

  • Some legacy Macro parameters from Confluence Server are not supported yet. More details at our FAQ page. We have tagged these parameters with a (Legacy) prefix as seen below.

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

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

  • Some server-version parameters are currently unsupported and are ignored by the macro, but all server data will be retained. These functions will automatically work when the function is available in the future

Supported parameters

Unsupported parameters

What features would you like to see in Cloud?

Would you like to see more Server macro parameters in Cloud? Feel free to take our ongoing survey and we will prioritize accordingly.

Parameters

Name

Required

Migratable to Cloud?

Default Value

Description

Button text

  • (/)

  • NO

Text display for the link.

Link Text

  • (/)

  • YES

Text display for the link.

Source Type

  • (X)

  • YES

template

The type of page source that is being used.  

Source

  • (X)

  • YES

The name of the template to use or page to clone.

Live Template

  • (X)

  • YES

false

If set to true, the template will be "live". 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. 

Parent

  • (X)

  • YES

@self

The page you would like to be the parent of the new page.

If no parent page is desired, set parent to a blank value.

e.g. "parent=". There are also three special values:

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

  • @parent - sets the parent of the new page to the parent of the current page.

  • @home - sets the parent of the new page to the home page of the current space.

Field hint

  • (X)

  • NO

Hint for the Button Text field to guide users. e,g, “Enter a maximum of 255 characters.”

Prefix

  • (X)

  • PARTIAL

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. 

For example:

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


Postfix

  • (X)

  • PARTIAL

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. 

For example:

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

Labels

  • (X)

  • YES

The list of labels to attach to the new page.

Allow Rename

  • (X)

  • NO

If set to true, the user will be allowed to rename the page when it is being created. 

Name Field Width

  • (X)

  • NO

If set, this specifies the width of the name text field.

Can be any valid CSS width value, such as "300px" or "60%".

CSS Class

  • (X)

  • NO

(Deprecated) Sets a class for the displayed form items.

Editor View

N/A

Macro Edit View

Notes

N/A