Skip to main content
MindTouch Success Center

Site structure errors

The Structure Analysis Reports can contain Category errors, Guide errors, Topic errors, How-To errors, Reference errors, Unclassified errors, and customer or other errors.

It might be easier to address category and guide level errors before delving into article level errors.  This top-down approach will help you resolve issues by viewing the site from a more holistic vantage point.

Category errors

Category pages are the highest level article type and can live under other Category pages but not under other article types (Guide, Topic, How-To, Reference).

Errors:

  • Category under Guide
  • Category under Topic
  • Category under How-To
  • Category under Reference
  • Category under Unclassified
  • Category under Custom

To resolve: Move Category underneath lowest level Category within hierarchy.

Guide errors

Guide under Guide

Option 1: Move both Guides directly under the lowest level Category to make Guides siblings

Option 2: Change lower level Guide to an article:

  1. If the Guide is a parent to other articles, the Guide should be made a Topic. Otherwise, it can be made any article type (such as a Topic, How-to or Reference).
  2. Change article type from Guide to Topic, How-to or Reference.
  3. Remove Guide DekiScript (Navigation widget) from new article.

Guide under Topic

Option 1: Change Guide to Topic

  1. Change article type from Guide to Topic.
  2. Remove Guide DekiScript  (Navigation widget) from article.

Option 2: Change Topic to Guide

  1. Change article type from Topic to Guide.
  2. Move both Guides to become children of lowest level Category.
  3. Add Guide DekiScript to new Guide. To do this: Add a DekiScript code block to the bottom of the Guide and add Navigation widget code.

Guide under How-To

  1. Change article type from Guide to Topic.
  2. Move Topic underneath the closest Topic or Guide in its hierarchy.
  3. Remove Guide DekiScript.

Guide under Reference

  1. Change article type from Guide to Topic.
  2. Move Topic underneath the closest Topic or Guide in its hierarchy.
  3. Remove Guide DekiScript.

Guide under Unclassified

  1. Change article type from Guide to Topic.
  2. Move Topic underneath the closest Topic or Guide in its hierarchy.
  3. Remove Guide DekiScript.

Guide under Custom

  1. Change article type from Guide to Topic.
  2. Move Topic underneath the closest Topic or Guide in its hierarchy.
  3. Remove Guide DekiScript.

Topic errors

Topic under Category

Option 1: Change Topic to Guide

  1. Change article type from Topic to Guide.
  2. Add Guide DekiScript.

Option 2: Move Topic under nearest Guide within hierarchy

Topic under Topic
This is a warning and not a required change. MindTouch advises against deep hierarchies, recommending a horizontal organization as an alternative. To address, make the Topics siblings by moving the lower-level guide up the hierarchy.

Topic under How-To
Option 1:  Move Topic under nearest Guide or Topic
Option 2:  Change How-to to Topic - Change article type from How-to to Topic.

Topic under Reference
Option 1:  Move Topic under nearest Guide or Topic
Option 2:  Change Reference to Topic - Change article type from Reference to Topic.

Topic under Unclassified
Option 1:  Move Topic under nearest Guide or Topic
Option 2:  Change Unclassified to Topic - Change article type from (not set) to Topic.

Topic under Custom
Option 1:  Move Topic under nearest Guide or Topic
Option 2:  Change custom article to Topic - Change article type from custom article to Topic.

How-To errors

How-To underneath Category
Move How-to article to under a Guide.

How-To underneath How-To
Option 1:  Change top level How-to article to Topic - Change article type from How-to to Topic.
Option 2:  Move bottom level How-to article under a Topic or Guide

How-To underneath Reference
Option 1:  Change Reference article to Topic -Change article type from Reference to Topic.
Option 2:  Move How-to article underneath a Topic or Guide

How-To under Unclassified
Option 1:  Change Unclassified article to Topic - Change article type from (not set) to Topic.
Option 2:  Move How-to article underneath a Topic or Guide

How-To underneath Custom
Move How-to article underneath a Topic or Guide.

Reference errors

Reference under Category
Move Reference article to under a Guide.

Reference under How-To
Option 1:  Change How-to article to Topic - Change article type from How-to to Topic.
Option 2:  Move Reference article underneath a Topic or Guide

Reference under Reference
Option 1:  Change top level Reference article to Topic - Change article type from Reference to Topic.
Option 2:  Move bottom level Reference article under a Topic or Guide

Reference under Unclassified
Option 1:  Change Unclassified article to Topic - Change article type from (not set) to Topic.
Option 2:  Move Reference article underneath a Topic or Guide

Reference under Custom
Move Reference article underneath a Topic or Guide.

Unclassified errors

Page has no article type: All pages on your site should include an article type association. If your page does not include an article type, expand Page settingsand choose an option from the Article type drop-down menu.

Unclassified page not under Home page
Unclassified articles can only fall under a Category and only if that Category is the home page. If not, consider the following two options when addressing this error:

Option 1:  Move Unclassified page underneath Home page. - Home page must be classified as a Category

Option 2:  Classify the Unclassified page.

  1. Change article type from (not set) to desired article type.
  2. Add appropriate DekiScript if Category or Guide: If the article type is to be a Category, add Category DekiScript.  To do this:

{Custom} page errors

You have the option to create custom article types (MindTouch standard article types include: Category, Guide, Topic, Reference, and How-to).  If an error pertaining to a custom article type surfaces, the report will list the error by the name of the custom article type.  The documentation associated with the custom article type will remain labeled {Custom}.

 

{Custom} under Category
Move custom article to under a Guide.

{Custom} under How-To
Option 1:  Change How-to to Topic - Change article type from How-to to Topic.
Option 2:  Move custom article underneath a Topic or Guide

{Custom} under Reference
Option 1:  Change Reference to Topic - Change article type from Reference to Topic.
Option 2:  Move custom article underneath a Topic or Guide

{Custom} under Unclassified
Option 1:  Change Unclassified article to Topic - Change article type from (not set) to Topic.
Option 2:  Move custom article underneath a Topic or Guide

{Custom} under Custom
Option 1:  Change top level custom article to Topic - Change article type from Custom to Topic
Option 2:  Move bottom level custom article under a Topic or Guide

Other errors

Page contains multiple article types
Sometimes an article will have multiple article types. To resolve, change the article type classification to the desired article. If the article type classification is already correct, select an alternate article type, then re-select the appropriate article type.

  • Was this article helpful?