Skip to main content
MindTouch Success Center

Add a guide

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

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 Add new page dialog may present page types that do not conform with proper site structure. Be sure to select only page types appropriate to the current position in the hierarchy.  Contact if you would like MindTouch to present only structure-appropriate article types in the Add new page dialog.

  1. Select the Guide template (The guide template is only available under a category page).
  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 beneath a guide.  Only create guides beneath categories. 

Add content to your guide

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

Both the DekiScript code at the top of the page, and any references to article type tags (such as the line "Tags recommended by the template: article:topic-guide") determine how the page behaves. If you see these lines on newly created pages, do not remove them.

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

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. 

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?