Skip to main content

Add a how-to page

This page applies to:MindTouch Responsive

The how-to article is likely your most important asset to leverage in MindTouch. From providing step-by-step instructions on how to accomplish a specific task related to your product or service, to allowing your customers to self-serve and inevitably increasing your Web presence, the how-to article is the major component to turn your help content  form a cost center to a revenue generator.


Create a new how-to page

  1. On the MindTouch toolbar, click New.


  1. Select the How-To template.
  2. ​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.


Add content to your how-to article

  1. Title your page. 
  2. Replace text with your content.

   Do not remove the "Tags recommended by the template . . ." line. This line determines how the page structurally behaves in MindTouch.

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

  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.

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


Publish your how-to 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?