This documentation relates to the latest version of Confluence.
If you are using an earlier version, please go to the documentation home page and select the relevant previous version.

Working with Templates Overview

Added by Vidya Madabushi, last edited by Sarah Maddox on Jun 10, 2008  (view change) show comment
Confluence 2.8 Documentation

Index

You can create a template which allows you to create an editable form. The form is displayed when a user creates a page, so that the user can enter page content.

For example:

  • A software development project may have a template for use-cases.
  • A systems administration space may have a template for defining what information is kept about each server.

In Confluence, there are two types of templates:

Global templates can only be created by site administrators, and space templates by space administrators.

Templates are written in regular Confluence markup, using special markup to define form fields that need to be filled in.

Here is an example:

Note

Currently, templates can only be used to create a page. Once a page is created, the template is gone and all further editing is performed as if the template was never used. Some plugins provide expanded functionality for strictly templated content. See below for more information.

Important Plugins For Templates

Two popular plugins that expand on template behaviour are the Zones Plugin and Scaffolding Plugin. Below is a comparision:

Field Default Zones Plugin Scaffolding Plugin
Description Basic Flexible Powerful
Saves page version history
Allows return to form version
Suitable for dynamic data
Has a library of examples
RELATED TOPICS
Adding a Template
Creating a Page using a Template
Editing a template
Removing a Template
User Macros
Working with Pages Overview
Working with Templates Overview

Take me back to Confluence User Guide

Labels

 

Comments (7)

 

  1. Mar 03

    Mark DiFilippo says:

    Hello, Is there a way in using addpage:template that a parameter such as title=@...

    Hello, Is there a way in using add-page:template that a parameter such as title=@self be used so that when the user clicks on this add-page link, the new page that gets created already has the name of its parent page populated in the title field thus allowing the user to only have to add a prefix or suffix to this title to keep it unique within a given space? I hope this request makes sense. Thanks

    1. Mar 03

      David Peterson says:

      Not exactly. You can use \ , or put any other reportstyle data into the title (e...

      Not exactly. You can use {link-page:name=%content:title% - Something Else|template=...}, or put any other report-style data into the title (eg. '%global:current time > yyyy-MM-dd%', '%data:My Field%'), etc. What you really want is to be able to specify {add-page:prefix=%content:title%|template=...} which doesn't exist yet. I'm not sure if there is a feature request for this yet, but it would seem like a good idea. I think the main reason it doesn't exist yet is making it work simply with non-live templates, which use Confluence's built-in template system.

      1. Mar 04

        Mark DiFilippo says:

        Thanks for your quick reply David.  I will investigate the feature request.

        Thanks for your quick reply David.  I will investigate the feature request.

  2. Mar 10

    Barbara Key says:

    Is there a way that I am not aware of that would allow me to attach files to my ...

    Is there a way that I am not aware of that would allow me to attach files to my template?

    1. Mar 10

      Choy Li Tham says:

      Hi Barbara, Unfortunately, Confluence does not support this feature currently. ...

      Hi Barbara,

      Unfortunately, Confluence does not support this feature currently. However, there is an improvement request being tracked at the following link:

      The improvement request above stated that Confluence should support the functionality to add attachment in templates. If you are keen on this improvement, please cast a vote to increase its popularity and add yourself as a watcher for future updates. Also, you may want to add a comment to the improvement request to truly reflect the importance of this improvement.

      Regards,
      Choy Li

  3. Apr 10

    Anonymous says:

    Can a template be configured so that when a page is created from it, that page a...

    Can a template be configured so that when a page is created from it, that page automatically becomes the child of "Home" in the space?

    1. Apr 11

      Tony Cheah Tong Nyee says:

      Hi there, An Idea I can think of is to have Create Page Macro

      Hi there,

      An Idea I can think of is to have Create Page Macro defined in the template. The Create Page macro allows defining a specific parent page for every page being created using the macro. For information regarding the usage of the create-page macro, please see:

      If I have misinterpreted your question, please further clarify for better understanding.

      Cheers,
      Tony

Add Comment