Customizing the Space Blueprint Form

When creating new spaces the 'Create Space' dialog will be prompted. Within there users get to choose a Space Blueprint and interact with the Space Blueprint Form. To configure the Space Blueprint form click on the second icon from the left.

Configuring the Space Blueprint Form

The Blueprint Creator allows you to customize the form by adding instructions. It also displays the system placeholders 'Space name', 'Space key' and 'Description'. These three can neither be deleted nor moved.

The system placeholders are not available as regular placeholders as they cannot be customized in any way. If you want to embed them on a Confluence page, you can create a user macro for that.

 Click here to expand...

Space name

Macro details fieldDescription
Macro namecurrentspacename
Visibility 

Visible to all users

Macro TitleCurrent Space Name
DescriptionDisplays the name of the current space.
CategoriesConfluence content
Icon URLEnter an absolute URL (for example http://mysite.com/mypath/status.png) or path relative to the Confluence base URL (for example /images/icons/macrobrowser/status.png) if you want the macro browser to display an icon for your macro.
Documentation URLIf you have documentation for your macro, enter the URL here.
Macro Body Processing

No macro body


## @noparams
<span class="current-space-name">$space.name</span>

Space key

Macro details fieldDescription
Macro namecurrentspacekey
VisibilityVisible to all users
Macro TitleCurrent Space Name
DescriptionDisplays the key of the current space.
CategoriesConfluence content
Icon URLEnter an absolute URL (for example http://mysite.com/mypath/status.png) or path relative to the Confluence base URL (for example /images/icons/macrobrowser/status.png) if you want the macro browser to display an icon for your macro.
Documentation URLIf you have documentation for your macro, enter the URL here.
Macro Body ProcessingNo macro body
## @noparams
<span class="current-space-key">$space.key</span>


If you are using placeholders in your Space Blueprint this is where they will be prompted to users.

Adding slides

To not overwhelm the user with a very long form and provide him with contextual instructions you can add slides to the Space Blueprint Form and assign placeholders to them (pagination).

Click on '(plus)Add slide' to create a new page for the form and move the placeholders you want to by drag & drop. The order of the placeholders matches the view in 'Create space' dialog.

You can also add instructions to each slide helping users understand how to use the placeholders.

Deleting placeholders permanently 

If a placeholder is not required anymore you only need to click on the delete icon. 

 

The placeholder will be marked by deletion. If you reconsider you can revert the decision by clicking on the revert icon or by clicking on 'Cancel'.

If you click ‘Save' the placeholder will be permanently deleted. They will neither show up in the placeholder sidebar of the Space Blueprint nor in the Space Blueprint Form when creating a new space.

Once deleted placeholders cannot be restored.

Your changes in the Space Blueprint Form directly affect the display for users who create new spaces using the Space Blueprint.

On this page