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

Notes for migration are provided at server documentation here. More details at our FAQ page. 

Parameters

Name

Required

Default Value

Description

Button text

  • (/)

Text display for the link.

Source Type

  • (X)

Template/blueprint

The type of page source that is being used.  

Source

  • (X)

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

Parent

  • (X)

Current page

The target parent for the new page. Defaults to the current page.

NOTE

The special values @self, @parent, and @home are no longer supported in Cloud. Existing macros with these special values will continue to work, unless the Parent field is updated to another page.

Field hint

  • (X)

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

Prefix

  • (X)

(warning) Injections are not supported on Cloud. For example, “%page:title% - Meeting Notes” would result in the literal text "%page:title% - Meeting Notes" instead of "My Page Title - Meeting Notes" when migrated to Cloud.

The prefix to apply before the page name. May contain these functions:

  • $spaceKey to use the targeted page's Confluence space key as prefix.

  • $spaceName to use the targeted page's Confluence space name as prefix.

  • $date(<date-format>) to output the current time and date e.g. $date(YYYY-MM-dd HH:mm a). Supported date-formats are as follows:

Click here to expand table...

Format

Output

Description

YY

18

Two-digit year

YYYY

2018

Four-digit year

M

1-12

The month, beginning at 1

MM

01-12

The month, 2-digits

MMM

Jan-Dec

The abbreviated month name

MMMM

January-December

The full month name

D

1-31

The day of the month

DD

01-31

The day of the month, 2-digits

d

0-6

The day of the week, with Sunday as 0

dd

Su-Sa

The min name of the day of the week

ddd

Sun-Sat

The short name of the day of the week

dddd

Sunday-Saturday

The name of the day of the week

H

0-23

The hour

HH

00-23

The hour, 2-digits

h

1-12

The hour, 12-hour clock

hh

01-12

The hour, 12-hour clock, 2-digits

m

0-59

The minute

mm

00-59

The minute, 2-digits

s

0-59

The second

ss

00-59

The second, 2-digits

SSS

000-999

The millisecond, 3-digits

Z

+5:00

The offset from UTC

ZZ

+0500

The offset from UTC, 2-digits

A

AM PM


a

am pm


  • $id(<format>,<startAt>) to assign incremental IDs e.g. $id(000,1)

Postfix

  • (X)

(warning) Injections are not supported on Cloud. For example, “%page:title% - Meeting Notes” would result in the literal text "%page:title% - Meeting Notes" instead of "My Page Title - Meeting Notes" when migrated to Cloud.

The postfix to apply before the page name. May contain these functions:

  • $spaceKey to use the targeted page's Confluence space key as prefix.

  • $spaceName to use use the targeted page's Confluence space name as prefix.

  • $date(<date-format>) to output the current time and date e.g. $date(YYYY-MM-dd HH:mm a). Supported date-formats are as follows:

Click here to expand table...

Format

Output

Description

YY

18

Two-digit year

YYYY

2018

Four-digit year

M

1-12

The month, beginning at 1

MM

01-12

The month, 2-digits

MMM

Jan-Dec

The abbreviated month name

MMMM

January-December

The full month name

D

1-31

The day of the month

DD

01-31

The day of the month, 2-digits

d

0-6

The day of the week, with Sunday as 0

dd

Su-Sa

The min name of the day of the week

ddd

Sun-Sat

The short name of the day of the week

dddd

Sunday-Saturday

The name of the day of the week

H

0-23

The hour

HH

00-23

The hour, 2-digits

h

1-12

The hour, 12-hour clock

hh

01-12

The hour, 12-hour clock, 2-digits

m

0-59

The minute

mm

00-59

The minute, 2-digits

s

0-59

The second

ss

00-59

The second, 2-digits

SSS

000-999

The millisecond, 3-digits

Z

+5:00

The offset from UTC

ZZ

+0500

The offset from UTC, 2-digits

A

AM PM


a

am pm


  • $id(<format>,<startAt>) to assign incremental IDs e.g. $id(000,1)

Labels

  • (X)

The list of labels to attach to the new page.

Editor View

N/A

Macro Edit View

Notes

N/A