Creating Sections

Content structure builds the navigation for the end user. Sections, subsections and articles are the terms best used to describe how your content can be structured.

On the IoGT Wagtail CMS, Sections and Subsection describe the navigational relationship between any higher page (a Parent Page) and lower page (a Child Page). Additionally, a Section can be both a Parent Page and a Child Page at the same time: it is a Child of its containing Section Page and a Parent Page to any Pages it contains. Sections can be nested as many times as needed. Specfic content Pages, such as an Article, Poll, Quiz, or Survey, are the last Pages in a lineage of Sections/Subsection.

The hierarchy of Sections and Subsections is similar to folders on your computer’s operating system. Your desktop folder is comparable to a root Section, with folders on your desktop as Subsection. Files present both on your desktop and within folders are comparable to Pages that appear and the end of a lineage of Sections/Subsections.

A special type of Page, called the Homepage, can be used to group several Sections together. Homepages are best used to group content of the same language together. For example, in a country that serves both English and French content, the site root could contain two Homepages, one for English content and the other for French Content. A Homepage can also have special Child Pages contained within it called Index Pages. Index Pages are a type of Section which only contains content of the same type. For example, a Section Index Page can only contain Sections within it. No Articles, Polls, etc. can be an immediate Child of a Section Index Page.

Note: these Sections can include Articles, etc. These Pages would be the “grandchildren” of the Section Index Page, and as such, do not violate the rule that Section Index Pages may only contain Sections as immediate children. Additionally, Index Pages are only available as Child Pages of a Homepage.

If you have a limited amount of content, you may only need to create sections for your articles without adding subsections.

Typically a website has minimum three navigational levels, but it is up to you how many you want:

Section > Subsection > Article;

And in the example below: Sport > Soccer > Doe Injured.

Pages hierarchy diagram
This is the pages hierarchy. Remember, Sections can be infinitely nested and can contain any Page type except Banner Pages and Index Pages. There can also be as many Site Languages as required.
Example of a subsection hierarchy
Example of a subsection hierarchy

On Wagtail, a section is a Content Channel, such as “Facts for Life” or “Early Life Tips”. A subsection is a category, such as “Facts for New Moms”. Subsections can nest as deep as content organizers would like. Articles are always children of subsections, though they can appear at any nesting depth.

Subsection hierarchy in IoGT
IoGT site demonstration of the subsection hierarchy. In this situation, 'Facts for Life' is the Section/Content Channel, 'About Facts for Life' and 'Facts For: New Moms' are both subsections/categories, and 'Birth and family life planning' and 'Having a baby and keeping it healthy' are Articles under the 'Facts For: New Moms' subsection.

Creating Subsections

  • To create a section, navigate through Pages > Site language > Sections
    • To create a subsection, continue selecting deeper subsections as required. Your new subsection will be contained within the subsection of your choice. The process for creating a Section versus a subsection is the same.
Sections root view
This is the Sections root. Any Sections created here will be parent Sections/Content Channels. To create a subsection, keep navigating down a Section.
  • Next, select ADD CHILD PAGE. The only required field is the title, as indicated by the red asterisk. However, it is recommend to add a section description as well.
Adding a new section
Adding a new Section/Content Channel. The title field is required, but the description field is highly recommended.
  • Main sections or content channels (e.g Facts For Life, Connect Smart, Your rights etc…) will always be displayed on the Home page. Your readers will use these sections (or categories) to navigate through your content.
  • For advanced settings click on Promote to adjust the URL slug page title, search descriptions
  • Click on Settings to schedule the publishing / unpublishing of this page at a future date and time of your choice.
  • Once you have completed all the required fields, select Publish from the dropdown menu at the bottom. Choose Preview if you’d like to see what it will look like first.
  • This section will now be listed under Sections on the Main page, where you can navigate your list of sections.
  • Hover over the section title to edit, view live, move to another section or unpublish.
  • There is no limit to the number of main sections you can add to your site. However, because these will be displayed on the Home page as your site Menu items, try not to exceed 4 main sections or content categories.
  • To create a section under a section (a subsection or a category) you can add a Child page to that section.
  • To add a child page, hover over the section title where a button bar will be displayed.