Skip to main content

Add a guide

This page applies to:MindTouch Responsive

As you are moving down your architecture, your content levels will become more and more specific. Once you have built your last category level, it is time to add your next content level—the guide. If you broke your category levels out by products, for example, you now may decide to start building version guides to lead your users even closer to finding the right answers.

Create a new guide

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


  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.


Add content to your guide

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

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

  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.

  NOTE:  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 key words. 


  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.)

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


Publish your 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 content that will really make your users happy. If you know you have a lot of individual articles, add topics to your guides next to provide that extra level of organization. But there is nothing wrong with adding how-tos or references directly to your guides if your articles can't be categorized easily underneath 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?