Add Page via Form

Add Page via Form

Description

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

Similar to the Add Page macro, this will create a new page, which can be based on a template.

Notes about migration

  • Some legacy macro parameters from the Confluence Server are not supported yet. More details are on our FAQ page. As seen below, we have tagged these parameters with a (Legacy) prefix.

  • Server users migrating to 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.

  • Some server-version parameters are current.” 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

Link Text

(V)

YES

 

Label for the button in the form.

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. 

Field hint

(X)

 

NO

 

Limit to 255 Characters

Hint for the field in the form to guide users.

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.

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.

width

(X)

 

NO

 

 

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

It 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.

Macro edit view

add_page_via_form_macro_editor.png