• Products
  • Documentation
  • Resources

Create a global template

As a site admin, you can create page templates in Confluence Cloud and make them available in every space on your site. For information on how to create a template that is available only in a specific space, see Create a template.

Only site administrators can create or edit global templates in Confluence Cloud.

To create a global template:

  1. If you aren’t already there, go to your Confluence Cloud site.

  2. Select the settings wheel () in the top right corner to open site settings.

  3. Select Global Templates and Blueprintsfrom the sidebar (under Configuration).

  4. Select Add global page template.

Help people discover custom templates by adding a description that will appear in the template gallery. To add or edit the description for a global template, go to Settings > Global Blueprints and Templates and click the pencil icon.

Editing a template is a lot like editing a page – there are only a few small differences. Currently, there’s no way to add images or attachments in templates. However, you can include variables, placeholder text, and labels. These features help people using these templates create rich and dynamic pages quickly.

Variables

When someone creates a page from a template with variables, they’ll fill out a form with text fields or lists for each variable in the template. The information they provide will be added to the page automatically.

Add a variable to a template

You can only add variables to templates created with the new editor.

To add a variable:

  1. Type /variable, then hit Enter.

  2. Select the variable token, then select to edit it.

  3. Enter a name for the variable, then select Text, Multi-line Text, or List.

  4. Select Save.

Variables with the same name must have the same parameters, as Confluence treats these as copies of the same variable. When someone creates a page from a template with two or more copies of the same variable, the text they enter for one variable will appear everywhere that a copy of that variable appears.

Example

The example below shows a custom template with five text variables — one for “New Hire,” one for “Company,” one for “Job Title,” one for “Team,” and one for “Manager”:

A sample template with text variables for "New Hire," "Company," "Team," "Job Title," and "Manager."

When someone creates a page from this template, they will be prompted to enter text into the fields where the variables appear:

When you create a page from a template with variables, you'll be asked to enter values for those variables first.

When they’re finished, the text they entered will appear on the page in edit mode.

 

Placeholder text

Use placeholder text to add instructions or sample text to pages created from a template. Placeholder text will only appear when a page is being edited – it’s invisible to anyone who’s viewing the published version.

Add placeholder text to a template

To add placeholder text to a template in the legacy editor:

  1. Select +, then select Placeholder text.

  2. Type in your placeholder text, then hit Enter.

To add placeholder text to a template in the new editor:

  1. Type /placeholder where you want the text to appear, then hit Enter.

  2. Type in your placeholder text, then hit Enter again.

Example

The example below shows a section of the Design Systems Template that comes with Confluence Cloud. The grey text is placeholder text:

Placeholder text from the Design Systems Template in Confluence Cloud.

When someone creates a page from this template, they will see grey placeholder text while they are editing the template. However, the text will not appear in view mode. This way, it is possible to provide instructions to the person creating a page from the template without any viewers of the page seeing them.

Labels

Add a label to a template to apply it to every page created from that template. This is helpful if you want to create a page properties report to keep track of similar pages.

Add labels to a template

To add labels to a template in the legacy editor:

  1. Select the tag icon next to the breadcrumb.

  2. Enter labels into the box, separated by the Space key.

  3. Select Add.

  4. Select Close.

To add labels to a template in the new editor:

  1. Select ••• > Add labels.

  2. Enter labels into the box, separated by the Space key.

  3. Select Add.

  4. Select Close.

Example

See Create a custom report for several examples of templates with labels.

Last modified on Jun 25, 2021
Cached at 6:20 AM on Jul 27, 2021 |

Additional Help

Ask the Community