Documentation for Confluence 4.1.x. Documentation for earlier versions of Confluence is available too.

Skip to end of metadata
Comment: Corrected links that should have been relative instead of absolute.
Go to start of metadata

Confluence allows you to create a page based on a global template (available to all spaces) or a space template (available only to that space). This page is intended for users who have already created a template.

Labels are copied from the template

If the template contains labels, the template labels will automatically be included in the new page created from that template.

To create a page using an existing template:

  1. Do either of the following:
    • At the top of the Dashboard, click Add Page. Choose the space that contains the template you want to use.
    • At the top of any other page, choose Add > Page from template.
      This link is only displayed if there are templates already defined. If you do not see this link, then an administrator will have to create a template before you can use it.
  2. Choose a template from the list and click Next. This will display one of the following:
    • A new page based on the template, if the template does not contain a form.
    • The Template Variables page, if the template contains a form. Type values into the form fields and click Insert Variables. This will display a new page based on the template, with the variable values you entered.
  3. Type a name for the page where you see 'New Page'.
  4. Add more content or make further changes as required.
  5. Click Save.

Screenshot: creating a page from a template


Screenshot: previewing your page


Related Topics

Adding a Template
Editing a template
Removing a Template
Form Field Markup for Templates
Browsing a space
Working with Templates

Take me back to Confluence User's Guide

63 Comments

Hide/Show Comments

  1. Apr 04, 2006

    Martin Cleaver [blended perspectives]

    How do I add a label to pages made from the template?

    I want every page to have a certain label.

    Thanks

    1. Jul 10, 2006

      Matt Ryall (Atlassian)

      Adaptavist have a plugin that lets you do just that:

      http://www.adaptavist.com/display/USERGUIDE/add-label+macro

  2. May 15, 2006

    Marianne Vanhauwaert

    Can I use templates from other spaces to create a page?

    Thanks,

    Marianne

    1. Jul 10, 2006

      Matt Ryall (Atlassian)

      Unfortunately, this isn't possible in Confluence at the moment. If you need this functionality frequently, you could raise a feature request in JIRA.

      1. Oct 23, 2006

        David Aldrich

        We need this functionality. I have created an improvement request in JIRA. Please vote for it if you are interested.

        1. Oct 23, 2006

          David Aldrich

          Sorry, I omitted the link to the issue, its CONF-7200.

  3. Aug 07, 2006

    Matt Zukowski

    Is it possible to link directly to a template? i.e. when the user clicks on the link, they should be taken directly to the template form so that they can start creating the page using the template...

    1. Aug 07, 2006

      Guy Fraser (Adaptavist)

      Yes - use the Create Page macro:

      http://www.adaptavist.com/display/USERGUIDE/create-page+macro

      A recent release adds full support for standard Confluence templates - see Create Page Macro

  4. Aug 21, 2006

    Mike Grady

    I'd like to create a template that has a list of values for a Wiki page link, or text entry box for such. The template form does not seem to recognize a syntax like:
    [@DIVISION|list(ClassTech,CommTech,CSS)] or
    [@STAFF]
    Is there a way to do this in a template? (The list works fine if I remove the link [] on either side, but I want the pages created with the template to be linked to one of the DIVISION pages. So that when I go to a particular page for a DIVISION, the Info tab "links" section shows all the pages created related to that DIVISION. Is there another way to accomplish this?)

  5. Sep 12, 2006

    Stefan

    Is there a way to assign the page name of an new article within a template?

    1. Sep 13, 2006

      Peter R.

      I have this same request, I'd like to see if a template can drop in a default page title/name when used from the Create Page macro. Ideally it would be a standard name follwed by some unique identifier, like a date/time stampe.

      1. Nov 16, 2006

        Jörg Albrecht

        Same Request from my side.

        1. Sep 11, 2007

          Robert Tosch

          I want to create pages with generic page titles, too.

          I need a standard name followed by some unique identifier.

          Are there any possibilities already?

      2. Sep 11, 2007

        David Peterson [CustomWare]

        It doesn't just drop in from a template, but you can use the {link-page} macro from the Linking Plugin. Eg:

        {link-page:name=My Prefix - %global:current date > dd-MMM-yyyy%|template=My Template}Today's Page{link-page}

        You can use any valid Suppliers (ala the Reporting Plugin) between the %...% values.

        1. Feb 17, 2009

          Yao Ge

          Dave, is it possible to include parameters (name/value pairs) from URL into a link-page macro? I also want to know if it is possible to have templates take these kinds of variables to prepopulate fields in the page when the page is created. Thanks!

        2. Feb 17, 2009

          Stefan

          Hi David,

          can you tell me more about this notation:

          What else can be used here instead of "global" and "current date"? Is this notation also usable in other plugins?

          Thanks,

          Stefan

          1. Feb 17, 2009

            Yao Ge

            http://www.customware.net/repository/display/AtlassianPlugins/Suppliers

  6. Feb 22, 2007

    Tom J

    I create a page using the option "select a page template to start from". In the template, I want to make an attachment appear such that, whenever any user uses this template, the attachment also appears in the final page.

    For e.g., say the template provides an attachment, "readme.doc" in its contents, something like:

    [Readme|^Readme.doc]]

    Whenever the final page is created, every user using the template should be able to click on the "readme.doc" to open and read it contents.

    Is the above possible? I tried this but I am unsuccessful. The final page does not show the link properly.

  7. Jun 13, 2007

    Garnet R. Chaney

    When creating a link on page A that links to a new page, a page that I want someone else to create using a template, allow me to specify the template to use in the link from page A.

    I suggest this format:

    * [new page from template|Page name|template=Template Name To Use]

    1. Jun 13, 2007

      Peter R.

      You can do this today using the Linking Plug-in from CustomWare, an Atlassian partner. This example creates a child page of the page and uses the template "TEMPLATENAME":

      Hope this helps.

      Peter

  8. Nov 19, 2007

    Anonymous

    Is there a way to create multiple pages from a single "add" action? Pages would use the same "@" variables and have a pre-defined hierarchy.

    1. Nov 19, 2007

      James Mortimer

      This would be a great suggestion for an extension to the add-page or create-page macros.

    2. Feb 04, 2008

      Anonymous

      This definitely would be a great feature!

  9. Feb 06, 2008

    Erik Remley

    On step 2: Filling Template Variables, is there a way to require a variable be populated before selecting the "Insert Variables" button and creating the new page?

    1. Feb 06, 2008

      David Peterson [CustomWare]

      Not with the built-in variables, but you can definitely do it using Scaffolding.

  10. Feb 06, 2008

    Anonymous

    When creating a page from a template, and a field on the page is  (NAME),

    I would appreciate the capability to have the new  Page be automagically named:  "Some Static Text -  (NAME)

    If this is already possible, apologies for not reading all of the manual! 

    1. Feb 06, 2008

      Anonymous

      2nd try, with escapes and Preview:

      When creating a page from a template, and a field on the page is @NAME@,

      I would appreciate the capability to have the new Page be automagically named: "Some Static Text - UserEnteredNAMEValue

      If this is already possible, apologies for not reading all of the manual!

      1. Feb 06, 2008

        David Peterson [CustomWare]

        I don't think this is possible presently, even using Scaffolding or Linking. The closest you'll get is using the add-page macro from the Linking Plugin.

        1. Feb 07, 2008

          Anonymous

          OK.  Pouting nearly over..Done.

          Well, I am trying to make easy-to-get-right page creation of a standard form for folks not likely to be strong wiki users.  Do I have a means to include instructions that will be visible to a user filling out a template, but will not become part of the saved page?  E.g.:  Step 2:  Name your new page:  "Product Spec - " followed by the name of the product.?

          P.s. A Documentum adapter would be a fantastic reuse of the recently acquired / practiced skills and would hook two enterprise grade best-in-class tools together.. Please don't say you have a non-compete agreement with another large "document management" vendor!

          1. Feb 07, 2008

            Peter R.

            The extensions section on this site does, I think, exactly what you're looking for. Look at what happens when you go to http://confluence.atlassian.com/pages/createpage-entervariables.action?spaceKey=CONFEXT&fromPageId=164605&templateId=18 and see if that isn't along the lines of what you're thinking...

            I should mention that I have no idea how they did it and that the link above is from the Plugin Index page.

            1. Jan 08, 2012

              Anonymous

              Hi,

              I'm also interested in including instructions during page creation, but the link Peter R. gave above is not valid anymore.

              Does anyone have a clue where I could retrieve this information or find something related?

              Many thanks in advance!

              Renaud

          2. Feb 07, 2008

            Anonymous

            This will probably sound really salesy but TSG has some open-source products that might help you connect this to Documentum. I had the link to this thread pop up in a Google alert so I'm not a registered poster and you can feel free to disregard this post if you like. You might find the Open Content web service or Active Wizard form products useful. you can get more info on them and download the code at www.tsgrp.com

  11. Feb 08, 2008

    Erik Remley

    Is there a way, based on the variables predefined, to set one of them up to be the name of the page that will be created?I want our users to be able to fill out all of the needed information on the template and then review the page for submission.Right now they have to enter the new page name when reviewing. 
    Thanks

    Oops, just noticed new entery above that answers this question

    Sorry

  12. Feb 15, 2008

    Ellen Daleng

    None of our users are able to get the template variables inserted into the form using Internet Explorer 7.  Nothing happens when the button is pressed.  Firefox works ok.  Any idea what might cause this?

    1. Feb 18, 2008

      Choy Li Tham

      Hi Ellen,

      Please create a support request pertaining to this problem at the following Issue Tracker: https://support.atlassian.com

      Hence, we can further investigate the problem from there. Thanks.

      Regards,
      Choy Li

  13. Feb 28, 2008

    Anonymous

    Sorry I havn't created an account here yet.

    How do I create a page that allows the user to fill in the fields and then submit the form to me via email.  Is there a way to use form mark-up in a page instead of a template?

    Dave

    ddesautel@deltadentalwa.com

    Thanks!

    1. Feb 28, 2008

      Ming Giet Chong

      Hi Dave,

      There are few user feedback macros which may meet your requirement at:

      Hope this information helps.

      Regards,
      MG

  14. Apr 06, 2008

    gantoine

    Hi,

    I would like to know how I can create a form which permit to administrators to save datas in my own database.

    I tried adding a link to a JSP application but I don't know how I can manage the rigths of differents users because I don't want that administrators re-log themself.

    Thanks.

    1. Jun 03, 2011

      Ming Giet Chong

      Hi Gantoine,

      This feature is not supported in Confluence currently. Ideally, you might want to create your own plugin.

      Alternatively,I would advise you to direct your questions to Atlassian Answers as there might be other user/developers who have already implemented it and should be able to share their ideas with you.

      Regards,
      MG

  15. Apr 09, 2008

    Anonymous

    Hi. I am currently evaluating Confluence and have a question . . .  I created a Global Template using the "Expense Scaffold" script. When I create a new page using this template, I am not being presented with a form to fill out, but instead I simply have the basic expense scaffold code on the new page. What triggers a form to appear? Thanks.

    1. Apr 10, 2008

      Mei Yan Chan

      Hi,

      I'm not particularly sure of the Expense Scaffold script. Would you mind elaborating it a bit more and raise it in our support system at:

      Thanks.

      Regards,
      Mei

    2. Apr 10, 2008

      David Peterson [CustomWare]

      I'm guessing you're referring to the Expense Scaffold example. In that case, you will need the following:

      1. Install the Scaffolding Plugin
      2. Don't create the page using the 'select a template' link on the standard 'Add Page' screen. Instead, use the {add-page} macro from the Linking Plugin. If you use the former method, you will be presented with the wiki markup first, then when saving you will be able to fill in the form. If you use the {add-page} macro to create the link, you can do it in one step.

      1. Oct 07, 2010

        Duncan stone

        David, I know this is a couple of years since this post, but in case you are still there ... is there any trick to this?  We are using confluence verison 3.2. I have set up templates using the scaffolding plug in. On another page I use the add-page macro (or the add-page-form macro) but get the wiki markup page which has to be saved before being faced with the scaffolding form.  Do you, or anyone else, know of anything particular in the system settings that would cause this?

        If I do not use scaffolding macros in the template it generates a page in its saved form rather than in edit mode, so it seems to be as a result of including the scaffolding macros.

        Any assistance would be appreciated.

  16. May 28, 2008

    Anonymous

    Is  it possible to   define a template for Confluence space where with a single key press  we could setup a space which corresponds to a particular purpose.

    For example - Project site or Client site. also consider the fact that security settings we need to assign to each site based on predefined AD groups should also happen automatically.
     fmushfeq@hotmail.com

    Mushfeq 

    1. Jun 03, 2008

      Tony Cheah Tong Nyee

      Hi Mushfeq,

      I am not particularly sure if I understand your request. Did you mean that you would like to have a template that allow creating a Confluence's space based on specific input?
      If that is the case, I am sorry to say that I am not aware if there are any easy way to achieve this. Perhaps, you might want to try searching through in our Confluence Extension space and see if there are any existing plugins that may meet your requirements?
      If I have misinterpreted the question, please further clarify for a better understanding.

      Cheers,
      Tony

  17. Jul 18, 2008

    Anonymous

    The template=TEMPLATENAME command is not working for me. Any idea why?

    1. Jul 22, 2008

      Azwandi Mohd Aris [Atlassian]

      Hi there,

      I believe you are referring to Peter R.'s comment above. In order to use the command, you have to install the Linking Plugin and replace the "TEMPLATENAME" with your own template's name. Having said that, you must first create the template page by following the instructions specified on this page.

      Hope this helps.

      Cheers,
      Azwandi

  18. Aug 13, 2008

    Anonymous

    Is the source available for the template in the article?

    Thanks,

    Paul.

    1. Aug 14, 2008

      Azwandi Mohd Aris [Atlassian]

      Hello Paul,

      I am afraid that the source is not available. However, you can always refer to the following documentation pertaining to the markups:

      Hope this helps you out.

      Cheers,
      Azwandi

  19. Apr 11, 2009

    Jesse Wodin

    Hi, I'm using Confluence 2.10.2. I'd like to create the following "logbook" functionality, and templates seem like the right way to go. I'd like the user to click a "NEW LOG" button, which creates a page where they have to enter some fields "AUTHOR, TITLE," etc. This data is automatically posted on the page, and the user can enter text on the page, etc. However, once the page is submitted, is there a way to have a FORWARD and BACKWARD button on the page to move to the previous log entry, or the next log entry, instead of going up to the parent, and finding the previous entry? This is useful for browsing through many days of log entries, without going up and down in the heirarchy each time.

    Also, on the parent page where all of these children logbook pages are displayed, is there a way to indicate if pages have attachments (e.g. a small paperclip next to each page name?)

    Thanks

    Jesse

    1. Apr 23, 2009

      Arie Murdianto

      Hi,

      I am afraid that your query cannot be done. I would suggest you to raise an improvement request in our JIRA:

      Cheers,

    2. May 05, 2009

      Jesse Wodin

      Thanks, I think this solves my problem. How did you get this nice table to show up with the author and posted date?

      1. May 06, 2009

        Azwandi Mohd Aris [Atlassian]

        I think Ben uses the Blog Posts Macro. There is a few parameters available; you might want to play around with them (smile) There is also the Flexi Blog Posts Plugin, which is an improvised version of the orginal Blog Post Macro.

  20. May 29, 2009

    Anonymous

    Are templates avaialble for news entries? As in an earlier comment, we'd like to use the news entries as a type of logbook, and would like to provide one or more forms for the entries.

    1. Jun 02, 2009

      Zed Yap [Atlassian]

      Hi,

      As far as I know, the feature requested is not available yet. However, there is a feature request being raised in JIRA:

      Please add your comments to the discussion, vote on it and add yourself as a watcher for future updates. Also, please bear in mind the following document on how we schedule features for inclusion in our products: Implementation of New Features and Improvements.

      Hope that helps.
      Best rgds,
      Zed

  21. Oct 06, 2009

    Anonymous

    Hi,

    I just started evaluating Confluence. I created a global template and would like to setr it as default template, i.e. if a user clicks on "Add page", a new page fromt this template should be created. Can anyone tell me how I do this?

    Best regards,

    Daniel

    1. Oct 12, 2009

      Sashidaran Jayaraman [Atlassian]

      Hi Daniel,

      As far as I know, this feature is not currently available in Confluence. However, I have found a similar improvement request. Please add yourself as a watcher, vote for this request and add your own comments to this improvement request. For further details on how we include new features and improvements, you might want to read this page.

      As a temporary workaround, you might want to try out the suggestions in the improvement request:

      Hope this helps.

      Cheers
      JSashi

  22. Mar 18, 2010

    pascal goualard

    Hi there,

    I just started using Confluence and am looking for a way to force users to create pages through defined templates...

    is it possible?

    Thanks

    Regards

    1. Mar 22, 2010

      Sashidaran Jayaraman [Atlassian]

      Hi Pascal,

      I am afraid that this is not currently possible. However, I have found a similar improvement request. Please add yourself as a watcher, vote for this improvement and add your own comments to this request. For further details on how we include new features and improvements, you might want to read this page. As a workaround, you might want to try the instructions in this documentation

      Hope this helps.

      Cheers
      JSashi

  23. Nov 02, 2010

    Anonymous

    Is there a macro to create a page and specify a template to apply to the page?

    Thanks

  24. Jan 12, 2011

    Andrea Carta

    I have already created several templates.

    We have pages that are create/saved but with no content on them yet. I'd like content contributors to be able to access the templates for these pages but have not seen how they can do so once the page is created/saved.

    Are the templates accessible only accessible when first creating a page?

    Is there a way to access the templates once a page is already created?

    1. Feb 06, 2012

      Anonymous

      I'd like to know if this is possible, too. 

      Or better yet, if I make a change to a template, how do I get that change to propagate out to all the pages that have this template. 

      Makes no sense to me that neither of things would be currently impossible. 

      Sure, there was a plug in that appeared to do these things, but it has not been updated for Confluence 4.x. My company is about to standardize on using Confluence for documentation, and these are deal breaking issues.

  25. Feb 07, 2012

    Anonymous

    Hi

    Is it possible to create templates using macros, e.g. the div box macro?

    Thanks