This page is part of the guide to developing technical documentation on Confluence Wiki. We have already shown you how to create your technical documentation space. Now we offer an introduction to the templates that Confluence provides. |
Deciding Where to Put Your Templates
In Confluence, there are two places to store your page templates:
- Space templates: These page templates are available in a specific space only. People who have space administrator permission can define templates via the space administration screen.
- Global templates: These page templates are available in every space on the site. People who have Confluence Administrator permission can define the global templates via the Confluence Administration Console.
Decide whether your template is useful across more than one space.
- If yes, create a global template. You will need Confluence administrator permissions.
- If no, create a space template.
- You will need space administrator permissions for the relevant space(s).
- You may have already saved your documentation space as a template, as described in our guide to creating your documentation space. In that case, it may be useful to save your template page in your template space. When you later copy the space, the template pages will be copied too.
Creating a Global Template
- Choose the cog icon
at top right of the screen, then choose Confluence Admin. - Choose Global Templates in the left-hand panel.
- Choose Add New Global Template.
See Administering Site Templates for more information.
Creating a Space Template
- Go to the space and choose Space Tools on the sidebar.
- Choose Content Tools > Templates.
- Choose Add New Space Template.
If your space uses the Documentation theme:
- Choose Browse > Space Admin at the top of the screen.
Note: The 'Space Admin' option appears only if you are a space administrator for the space or you are a super user (a member of theconfluence-administratorsgroup). - Choose Templates from the space administration options.
- Choose Add New Space Template.
See Adding a Template for more information.
Importing Templates
Confluence ships with a number of templates, including the 'Charts', 'Document List' and 'Meeting Notes' templates. These templates are not available for use by default. However, if you have the appropriate permissions to access the Administration Console, you can import any of these templates to be used globally or within a specific space. In addition, you can find more template bundles on the Atlassian Plugin Exchange.
- Log in to Confluence as an administrator.
- Choose the cog icon
at top right of the screen, then choose Confluence Admin. - Choose Import Templates. The 'Import Templates' screen will appear, listing the template packages deployed to your Confluence instance and the templates included in each package.
- Select the templates you want to import.
Note: You can view a preview of the template by clicking the template name. - Choose the destination to Import To. If you want the templates to be available to your documentation space only, select the name of the space, otherwise select 'Global Templates' to make the templates available to all spaces.
- Choose Import to import the selected templates.
Using a Template to Create a Page
When people create a page on your Confluence site, they can choose to base their new page on a template.
Go to the page that will be the parent of your new page, and choose Create.
All available templates for that space will display, select a template then choose Next.
Next Steps
You now have a good idea of how Confluence templates work. What next? Take a look at Re-using Content in Technical Documentation.