Creating Content Templates

Content templates are pre-made documents that an author uses to create content. You can use templates for different document types that you use frequently. Using a template ensures consistency across your content set. It can hasten the authoring experience also. Templates are available for topics and maps.

Tip: If all your policy documents follow a similar format, it may be a good idea to create a template that contains the basic elements and structure used in that document type. By default, every user in your organization can use templates to create content.


Keep these guidelines in mind when creating templates:

  • You can restrict access to template configuration files to prevent unwanted changes to the templates.
  • You can add variable elements and map metadata to a template.
  • You can provide internal guidance on how to use a template by including draft comment elements or conditional processing attributes in the template.
  • You can include any allowed elements or content in a template.
    Note: Linking between template topics results in broken links. For more information, contact a Customer Success Manager.


Figure 1. Change Request Topic Template
topic template for change requests
Figure 2. Briefing Note Topic Template
topic template for briefing notes
Figure 3. Policy Map Template
map template for policy guides

Templates or specializations?

Templates are based on standard DITA map and topic elements and can be created by anyone. Specializations are extensions of the standard DITA elements. If you are interested in using specializations, contact your Customer Success Manager.