Skip to main content
MindTouch Success Center

Add a guide

This page applies to:MindTouch (current)

As you design your site architecture, your content levels will become increasingly specific. Once you have built your last category level, you can add the next content level—the guide. If you organized category levels by products, for example, you can then add guides which correspond to product versions. This will lead your users to the right answers with clear, obvious logic.

How to create a new guide

To create a new guide beneath a category, follow the steps below:

Step 1: Add a new guide

  1. Navigate to the category under which you want to create a guide.
  2. On your MindTouch toolbar, click New.


The new page dialog will appear.  Only the legal page templates will be made visible.

  1. Select the Guide template.
  2. Depending on whether you want to create the guide live or as a draft mode, select either the Create live or Create draft radio button. (You will be able to publish the draft to your live site later.)
  3. Click Create.


Do NOT create a guide underneath a guide.  Only create guides underneath categories. 

Step 2:  Add content to your guide

  1. Title your guide. 
  2. Replace placeholder text with your content.

Do not remove the DekiScript code boxes at the top of the page or the "Tags recommended by the template: article:topic-guide" line at the bottom of the page. Both determine how the guide page behaves.

  1. If applicable, add images, videos or tables to enhance your content.
  2. Click Save.

Step 3:  Configure the page settings of your guide

  1. Expand Page Settings.
  2. Hover over the Add page summary field to display the page summary icon   . 
  3. Click the icon and enter a page summary.

The page summary is not only the first paragraph that is displayed on your page, it also is the description that is displayed in MindTouch and Google search results, so make sure to include valuable keywords. 


  1. Click Add page thumbnail to add the display icon for your guide.
  2. Make sure that Article type is set to Guide
  3. If you have not yet set up any custom classifications, set a Stage value to help you later identify articles in certain stages of your workflow. 
  4. Apply appropriate Tags to your article. (You must hit Enter after entering each tag.)

Tags determine the articles MindTouch recommends at the bottom of your page, so keep tags consistent. The more related tags articles have in common, the more likely they will be recommended together. 

Step 4: Publish your guide (if a draft)

If you created your page in draft mode and are ready to publish your guide to your live site, click Publish.


What's next?

You now have created your guide and are ready to add authoritative content. If you know you have a lot of individual articles, add topics to your guides. Topics allow subtopics, for an extra level of organization. You can also add how-tos or references directly to your guides if your articles can't be categorized easily beneath topics. To make the articles and topics you added to your guide show up in the guide tabs, read our article on how to display pages in the guide tabs.

  • Was this article helpful?