Skip to main content
CanoeUX home

SharePoint Web Parts Essentials

CNX Table of Content

Turn a folder of pages into a navigation tree, so readers can browse a whole collection of related pages and always see where they are in it.

Overview

CNX Table of Content turns a folder of pages into a clear navigation tree. Keep related pages together in a folder of the site's Site Pages library, such as your policies, procedures, guides or a manual, and the web part lists every page and subfolder, so readers see the whole collection at a glance and open any page in one click.

It's built from the folder itself, so there's nothing to maintain: new pages appear on their own, subfolders become groups that open and close, and you set the order with a single SortBy column. On each page, the table of contents marks the page being read and opens the folders that lead to it, so readers always know where they are.

Add it beside the content of every page in the collection, to give readers a consistent way to move from page to page. Pair it with CNX On this page, which lists the sections of the page being read: one helps readers find the right page, the other the right section.

Features

Navigate a whole collection of pages

Every page and subfolder of the folder appears in one tree, each subfolder as a group that opens and closes. Below, the Frameworks and Policies page lists 21 frameworks and policies in their Corporate, Legal and People folders. The page being read is marked with a red line, the same marker as CNX On this page, and Expand All, Collapse All and Refresh sit beside the title.

The Frameworks and Policies page of a SharePoint site, below a forest banner with an introduction and a Need a hand? panel that lists two champions. Under the TABLE OF CONTENT title, with Expand All, Collapse All (showing its tooltip) and Refresh buttons on the right, the tree starts with Frameworks and Policies, marked with a red line as the current page, followed by the expanded Corporate, Legal and People folders. Each lists seven pages, such as Acceptable use of Artificial Intelligence Framework, Code of Conduct and Hybrid Work Policy.

View full-size image (opens in a new tab)

Always up to date

The tree is read from the folder whenever the page loads, so new, renamed and moved pages appear without any change to the web part. Pages are listed by their title, folders with nothing to show are left out, and Refresh reloads the tree without reloading the page.

Folders with a page of their own

Give a folder its own page by naming the page after the folder, such as Guides.aspx in the Guides folder: selecting the folder then opens that page, so each group can have its own introduction. The page of the folder you choose as the source is pinned at the top of the tree, as the Frameworks and Policies page is above.

In the order you choose

Enter a number in the SortBy column of the Site Pages library to put pages and folders in the order that makes sense, such as an introduction first. Numbers sort naturally, so 2 comes before 10, and pages without a number follow, by title. The web part adds the column for you.

Easy to use with a mouse or a keyboard

The current page is marked for screen readers as well as visually. Readers open and close folders with the mouse or the arrow keys, open a page with Enter, or open and close every folder at once with Expand All and Collapse All. Screen readers announce when the tree has been refreshed.

Ready for large collections

Collections of up to 200 pages and folders load at once, fully expanded. Larger ones load one folder at a time, as readers open them, and long lists show 200 entries at a time, with a button to show the rest.

Configuration

After the CanoeUX SharePoint Web Parts Essentials package has been deployed to your SharePoint tenant, you can add CNX Table of Content to any modern SharePoint page and point it at a folder of pages.

  1. Step 1: Organize your pages in a folder

    CNX Table of Content lists the pages of one folder in the site's Site Pages library, where the site's pages are kept. Create a folder for the collection, such as Frameworks and Policies, move its pages into it, and group them in subfolders if you like, such as Corporate, Legal and People.

    • To give a folder a page of its own, name the page after the folder, with hyphens or spaces between words, such as Frameworks-and-Policies.aspx. The source folder's page is pinned at the top of the tree; a subfolder's page opens when readers select the subfolder.
    • Give pages clear titles: the table of contents shows each page's title, and uses its file name only when it has none.

    Tip: You can also create the folder later, from the folder picker. If Site Pages doesn't allow folders yet, the web part turns them on the first time you add it, provided you can change the library's settings.

  2. Step 2: Edit the page

    Go to the SharePoint page where you want to add the web part, and select Edit.

    Important: The Edit button is in the upper-right corner of the page. If you don't see it, you don't have permission to edit the page: ask the site owner or a site administrator for edit permissions.

  3. Step 3: Add a new web part

    Hover over the section where you want the table of contents to appear, and select + Add a new web part. On the pages of the collection, a narrow column to the left of the content works well, so readers see the table of contents beside the page they're reading.

    Tip: Add the web part to every page in the folder, in the same place and pointing at the same folder, so readers can move from page to page.

  4. Step 4: Select CNX Table of Content

    In the web part toolbox, search for CNX Table of Content, and select it to add it to the page. Until it's connected to a folder, the web part shows Choose a source folder, with a Select source folder button that opens the folder picker. Readers see nothing until then.

  5. Step 5: Open the property pane

    Select the web part, and then select Edit properties in its toolbar.

    The toolbar of a selected web part: the move handle, the Edit properties button with its tooltip, and the Duplicate and Delete buttons.

    The property pane has two sections: Title and Source. SharePoint may add its own sections, such as Visibility, below them.

  6. Step 6: Configure the Title section

    Expand Title to choose the heading shown above the table of contents and how it looks.

    The CNX Table of Content property pane, with the introduction “Choose a folder to display its content as a structured table of contents, providing quick and easy navigation for users.” and a Learn more link. The Title section is expanded: Show title turned on, the Title box set to Table of Content, Automatic title color turned on, and a toolbar with font size, font weight, uppercase (selected), character spacing and reset buttons.

    Available options

    Show title

    On by default. Turn it off to show the table of contents without a title.

    Title

    The default is Table of Content. Enter your own, such as Policies or In this guide.

    Title formatting

    Use the toolbar below the title to change its:

    • Font size, from 10 to 40 points (10 by default);
    • Font weight, from Extra light to Bold (Semibold by default);
    • Uppercase, on by default;
    • Character spacing, the space between letters;
    • Title color: turn off Automatic title color first to choose your own. The automatic color stays readable on light and dark sections.

    Select Reset to defaults to go back to the original title and formatting.

  7. Step 7: Configure the Source section

    Expand Source to choose the folder whose pages make up the table of contents.

    A SharePoint page in edit mode with the Select a source folder dialog open. The dialog shows the Site Pages library of The Lake site, with a New folder button and two folders, Frameworks and Policies (5 items, selected) and Teams (2 items), then 1 selected, Select folder and Cancel. In the property pane on the right, the Source section is expanded, with the Source Folder button, Prerequisites with an information icon, and Selected folder set to Site Pages › Frameworks and Policies.

    View full-size image (opens in a new tab)

    Available options

    Source Folder

    Select Source Folder to open Select a source folder, which shows the folders of the site's Site Pages library. Select a folder, or create one with New folder, and then choose Select folder. Selected folder then shows its path, such as Site Pages › Frameworks and Policies.

    Only a folder inside the Site Pages library of this site can be chosen, not the library itself, a page, or a folder in another library or site.

    Prerequisites

    Select the information icon next to Prerequisites to see how to create a folder in Site Pages.

    Page order

    While you edit the page, the web part adds a SortBy column to Site Pages. In the library, enter a number in SortBy for each page or folder, such as 10, 20 and 30, to set the order within each level. Pages and folders without a number follow, by title. A folder takes the number of its own page, if it has one.

    Important: Turning on folders and adding the SortBy column require permission to change the settings of Site Pages, which site owners have. Without it, a message asks you to contact your administrator, and the table of contents is ordered by title.

  8. Step 8: Publish the page

    1. Select Republish (or Publish, if the page has never been published) to save your changes and make them available to readers.
    2. Open a few pages from the table of contents, and check that each one shows the right page as current.

    CNX Table of Content is now configured and ready to use. Readers need permission to read the pages in the folder; anyone without it sees a message instead of the table of contents.

Limits

Source and size

  • The pages must be in a folder of the Site Pages library of the same site: pages in other libraries or sites can't be listed.
  • Expand All is available for collections of up to 200 pages and folders. Larger collections open one folder at a time.
  • A folder with more than 20,000 items directly in it shows only the first 20,000.
  • The order is set in the SortBy column of the library; the web part has no ordering of its own.

Large collections

In collections of more than 200 pages and folders, which load one folder at a time:

  • a subfolder's own page is found only when its name matches the folder exactly, or with hyphens instead of spaces;
  • empty subfolders are listed, and show No pages yet when opened;
  • Refresh reopens up to 12 levels of open folders.

Examples

  • Policies and frameworks

    List all your policies, grouped by area, beside each one, with the folder's own page as an introduction to the collection.

  • Procedures and manuals

    Organize a multi-page manual or a set of procedures in chapters, with a subfolder per chapter and SortBy to keep them in order.

  • Project pages

    Give each project a folder of pages, such as its charter, plan, decisions and status reports, with the table of contents on every page.

  • Onboarding program

    Guide new employees through a series of pages, from their first day to their first month, in the order you choose.

Best practices

  • Add the web part to every page in the folder, in the same place and pointing at the same folder.
  • Give the folder its own page, named after it, to introduce the collection; it's pinned at the top of the tree.
  • Give every page a clear title: the table of contents shows titles, not file names.
  • Number SortBy in steps of 10, such as 10, 20 and 30, so you can insert pages later without renumbering.
  • Keep to two or three levels of folders, so the tree stays easy to scan.
  • On long pages, add CNX On this page too, so readers can move between the sections of the page they're reading.

Release notes

  1. Initial release

    October 2026

    • First release, included in CanoeUX SharePoint Web Parts Essentials.

Support

Have a question about CNX Table of Content, or found something that doesn't work as expected? Contact CanoeUX and tell us what you expected to happen and what happened instead. Screenshots help, and for display or access issues, so does the output of CNX User Diagnostics.

Planning a wider intranet? Explore our SharePoint and digital workplace services.

Free of charge

Support CanoeUX

CanoeUX SharePoint Web Parts Essentials is provided free of charge.

If these web parts helped you save time or deliver value to your organization, consider supporting future development.