• Products
  • Documentation
  • Resources

Create a template

Space administrators can create their own custom page templates in Confluence Cloud. To learn about creating global page templates—templates available to others—see Create a global template.

Only space administrators can create or edit templates in Confluence Cloud.

If you don’t have Admin permission for a space, you won’t see the Look and feel card when you go to Space settings and you won’t be able to create templates.

To create a template in a space:

  1. Go to the space in Confluence Cloud.

  2. Select Space settings from the sidebar. 

  3. Select Templates from the Look and feel card.

  4. Select Create new template.

Focuses on the Templates item in the Look and feel card of Space Settings

Help people discover custom templates by adding a description that will appear in the template gallery.

To add or edit a template’s description, go to Space Settings and select Templates from the Look and feel card, then select the pencil icon from the Description column.

 

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.
    A Text variable offers a single line of input text, a Multi-line variable is configurable for multiple rows and columns of input, and a List produces drop-down lists with definable options.

  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 .

  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.

 

 

Additional Help