Adding multiple article, section, and category templates to your theme

What's my plan?

Suite

Enterprise or Enterprise Plus

Support with

Guide Enterprise

Note: On Suite Growth and Professional or on Guide Professional with Support, you can access this feature and create multiple templates in a non-live theme to try it out. You cannot create multiple templates in your live theme.

In a Guide theme, there is one page template each for article, section, and category by default. You can create up to 100 additional page templates each for articles, sections, and categories.

This means that you can create alternate versions of templates to use for your articles, sections, and categories. You can change the look and feel based on content. You can apply or change the page template when you create or edit an article, section, or category.

You cannot create additional templates for any other page type in your theme. You must be a Guide admin to create multiple templates.

When you create additional custom templates for a theme, you can only select those templates if the theme you created them for is live. In other words, the theme must be active before you can select the custom templates associated with that theme.

Note: Page templates are different from Knowledge templates that you create for Knowledge. See Creating templates for Knowledge.

This article contains the following sections:

• Adding multiple templates using the theme editor
• Adding multiple templates in downloaded themes

Adding multiple templates using the theme editor

You can create additional page templates for articles, sections, and categories using the theme editor. If you prefer working on your themes locally, you can also add templates to your downloaded themes.

Note: Help center themes do not support template partials, which are smaller, reusable templates that can be imported into a parent template.

To add an article, section, or category template using the theme editor

1. In Knowledge admin, click Customize design () in the sidebar.

   Your themes appear on the Themes page.

2. On the theme you want to edit, click Customize.
3. Click Edit code.

   

4. In the Files area, click Add new, then select the template that you want to add.

   

5. Under Template for, select the type of template you'd like to create.

   You can create article, section, and category templates only. You can create up 100 additional templates for each type.

   

6. Enter a Template name.
7. Under Start from, select an existing template to copy and use as a starting point.

   You can select blank template if you don't want to start from another template.

8. Click Create template.

   The new template opens for you.

9. Edit your template and click Save as you go.
10. To preview your template, click Preview, then click Templates at the top of the preview and select the template you want to preview.

    

    For more information, see Previewing your theme while editing theme code.

When you are ready, you can apply your template to a new article or new category or section. You can also change the template on an existing article, section, or category.

Adding multiple templates in downloaded themes

If you download and work on themes locally, you can add multiple templates to the themes. The workflow consists of creating a predefined folder in a theme's templates folder, then adding .hbs template files to the folder.

To learn more about working on themes locally, see Working on a theme locally.

To add a template to an downloaded theme

1. Depending on the type of template you want to add (article, section, or category), create any of the following folders in the templates folder of the downloaded theme:
   • article_pages
   • section_pages
   • category_pages

   As in the Guide theme editor, you can only create article, section, and category templates.

2. Add an .hbs template file in the new folder.

   You can name the file anything you want. The name must be 25 characters or less, and snake_case.

   
   Tip: To save time, copy an existing .hbs file into the folder to use as a starting point for the new template.
3. Edit and save the template.
4. If you need to add more templates of the same type, add them to the same folder.
5. When you're done, zip the theme and import it into Guide.

Use Guide to preview the new template.

When you are ready, you can apply your template to a new article or new category or section. You can also change the template on an existing article, section, or category.

Note: You can create up to 100 page templates per article, section, and category.