Skip to main content
MindTouch Success Center

Add a how-to page

When do I use how-to pages?

The how-to page is one of three main article types in MindTouch, along with Topic and Reference pages. A how-to page is best used to explain how to solve a specific problem. A how-to page should only exist within a guide, or beneath a Topic page.

How to create a new how-to page

Select the how-to template  

  1. On the MindTouch toolbar, click New.
  2. Select the How-To template.
  3. Depending on whether you want to create the page live or as a draft, select either the Create live or Create draft radio button (you will be able to publish the draft to your live site later) and click Create.

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.

Add content to your how-to article

  1. Title your page. 
  2. Replace 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…") 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.

The MindTouch editor is similar to other document creation applications you've used in the past. Use the editor to bold, italicize or edit your text as you would normally perform in a document creation application.

Configure how-to page settings

  1. Expand Page Settings (above your new title).
  2. Hover over the Add page summary field to display the page summary icon  
  3. Click the page summary 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. Make sure that Article type is set to How-To
  2. 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. 
  3. Apply appropriate Tags to your article. (You must hit Enter after entering each tag.

Keep tags consistent. Tags help determine the articles MindTouch recommends at the bottom of each page. Articles with common tags are more likely to be considered related when MindTouch determines page recommendations.

Publish your how-to page (if a draft)

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

What's next?

You created a page and realize you want to make some changes to your content. Click here to get tips on editing your page.

  • Was this article helpful?