Skip to main content
CanoeUX home

SharePoint Web Parts Essentials

CNX On this page

Give long pages an automatic table of contents, built from their headings, that stays in view beside the content and shows readers where they are.

Overview

CNX On this page adds an automatic table of contents to any modern SharePoint page. It lists the page's headings, so readers see at a glance what a long page covers and go straight to the section they need, instead of scrolling through everything else.

There's nothing to maintain: the list is built from the heading styles you already use, and it updates by itself as you add, rename or remove headings. Show it in the page like any other web part, or let it float beside the content, where it stays in view as readers scroll and highlights the section they're reading.

Use it on any long page with many sections: policies and frameworks, procedures and guides, project and program pages, reports and onboarding material. A back button above the list can take readers to a related page, such as the page that lists all your policies.

Features

Easy navigation on long pages

Readers see every section of the page in one list, and select an entry to go straight to it. Entries are indented to follow the page's structure, and as readers scroll, the section they're reading is highlighted with a marker, so colour isn't the only cue. Below, a policy framework with 19 sections stays easy to navigate, with the table of contents pinned on the left and a back button to the page that lists all frameworks and policies.

A long SharePoint page, Acceptable use of Artificial Intelligence Framework, below a banner with its owner, effective date, renewal date and review frequency. On the left, beside the content, a red Frameworks and Policies back button sits above an ON THIS PAGE list: the page title, highlighted with a red marker as the current section, then every section in order, from 1. Purpose and 2. Scope to 19. Approval, with subsections such as 5.1. High-Risk Uses and 17.1. Monitoring. The page content starts with 1. Purpose, 2. Scope and 3. Definitions.

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

Always up to date

The table of contents is built from the page title and the headings in your content, including headings in other web parts on the page. It updates as soon as the page changes, even while you edit it, and leaves out empty headings and headings in collapsed sections. There's no list of links to maintain.

Stays in view while readers scroll

Choose Left or Right to float the table of contents beside the content. It uses the page's empty margin on wide screens and makes room beside the content on medium ones, stays pinned as readers scroll, and stops at the end of the page. On narrow screens, such as phones, it's shown in the page instead.

A way back

Add a back button above the list to take readers to a related page, such as the page that lists all your policies or guides. It can open in the same tab, a new tab or a new window, and its colours follow your site's theme unless you choose your own. On sites that use CNX Table of Content to navigate between pages, the button suggests the page that shows it.

Accessible by design

Entries are real links in a labelled navigation region, with a visible focus outline for keyboard users. Selecting one scrolls smoothly to its section, or straight there for people who prefer reduced motion, and moves keyboard focus to the heading so screen reader users continue reading from there.

Styled to fit your site

Rename the title or hide it, and adjust its size, weight, capitals, letter spacing and colour. The automatic title colour stays readable on any section background.

Configuration

After the CanoeUX SharePoint Web Parts Essentials package has been deployed to your SharePoint tenant, you can add CNX On this page to any modern SharePoint page that has headings.

  1. Step 1: 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.

  2. Step 2: Add a new web part

    Hover over the first section of the page, next to or just above the start of the content, and select + Add a new web part.

    Important: Add the web part to the top section of the page. SharePoint loads web parts lower down a page only when readers scroll to them, so a table of contents placed further down would appear late, if at all (see Limits below).

  3. Step 3: Select CNX On this page

    In the web part toolbox, search for CNX On this page, and select it to add it to the page. It lists the page's headings right away. On a page with no headings yet, you see No headings found yet, and readers see nothing.

  4. Step 4: 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 three sections: Title, Navigation and Back Destination. SharePoint may add its own sections, such as Visibility, below them.

  5. Step 5: Configure the Title section

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

    The CNX On this page property pane, with the introduction “Displays an automatic table of contents for the page, helping users quickly navigate through all sections.” and a Learn more link. The Title section is expanded: Show title turned on, the Title box set to On this page, Automatic title color turned on, and a toolbar with font size, font weight, uppercase (selected), character spacing and reset buttons. The Navigation, Back Destination and Visibility sections are collapsed.

    Available options

    Show title

    On by default. Turn it off to hide the title; screen readers still announce the list as On this page.

    Title

    The default is On this page. Enter your own, such as In this policy or Contents.

    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.

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

  6. Step 6: Configure the Navigation section

    Expand Navigation to choose which headings are listed and where the table of contents appears.

    The Navigation section of the property pane: Heading styles to include set to Heading 1 and Heading 2, then Placement tiles for Left (selected), Right and In place, each with an illustration, and the Top margin (px) slider set to 20.

    Available options

    Heading styles to include

    Choose Heading 1, Heading 1 and Heading 2 (the default), Heading 1 to Heading 3 or Heading 1 to Heading 4: the heading styles of the Text web part. The page title is always listed first.

    Tip: On long pages, one or two heading levels keep the table of contents short enough to scan.

    Placement
    • In place, the default: the table of contents is shown where you added the web part, in the flow of the page.
    • Left or Right: the table of contents floats beside the content and stays in view as readers scroll. On narrow screens, such as phones, it's shown in place.

    While you edit the page, the table of contents is always shown in place, with a note about where it will float after you save the page. With Left or Right, the property pane also reminds you to place the web part near the top of the page.

    Top margin (px)

    The space above the table of contents, from 0 to 120 pixels (20 by default). When it floats, it's the space between the top of the window and the table of contents.

  7. Step 7: Configure the Back Destination section

    Expand Back Destination to add a button above the table of contents that takes readers to a related page, such as the page that lists all your policies.

    The Back Destination section of the property pane: Show back destination turned on, a red Frameworks and Policies button with a back arrow, followed by Edit Properties and Remove buttons, and under Button colors, red Background color and Hover color swatches and a white Text color swatch.

    Available options

    Show back destination

    Off by default. Turn it on, then select Add link to set the button's text, destination and icon; it starts with a back arrow. The table of contents has one back button, so Add link disappears once it's added. Select Edit Properties on its row to change it in the Button properties panel. Remove deletes it straight away.

    If a page on the site shows CNX Table of Content, the link to it is suggested as soon as you turn the section on. When you pick a page of the site as the destination, its title becomes the button's text.

    Open in

    Open the destination in the same tab, a new tab or a new window.

    Button colors

    By default, the button follows your site's theme: the theme colour as its background, a readable text colour, and a second theme colour on hover. To choose your own, select Background color, Text color or Hover color, then pick a theme colour, a standard colour or More custom colors. Reset to default goes back to the theme colour.

    The colour picker open above the Button colors of the Back Destination section, with a Reset to default button, ten Theme colors in reds and greys, thirteen Standard colors including white, black and a no-colour swatch, and More custom colors.
  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. View the published page. With Left or Right, the table of contents now floats beside the content. Scroll, and select a few entries to check that every section is listed.

    CNX On this page is now configured and ready to use.

Limits

Add it to the top of the page

To keep pages fast, SharePoint first loads the web parts that are visible when a page opens. It loads the others only when readers scroll down to their section, and until then they don't run. This is how SharePoint works for every web part, and it can't be changed.

Important: Add CNX On this page to the first section of the page, next to or just above the start of the content. Further down, a Left or Right table of contents appears only once readers scroll to that section. It also makes room beside the content only in its own section and the sections below it.

Headings and links

  • Only the page title and Heading 1 to Heading 4 are listed. Text made to look like a heading, with bold or a larger font, isn't.
  • Headings in other web parts on the page are listed too when they match the selected heading styles.
  • Selecting an entry doesn't change the page's address, so you can't copy a link to a section from the table of contents.
  • The marker on the current section is red; it doesn't follow your theme colour.

Examples

  • Policies and frameworks

    Let readers jump to the clause that applies to them in a long policy, standard or framework, and return to the list of policies with a back button.

  • Procedures and guides

    Break a long procedure or how-to guide into sections, so people can find their place again.

  • Project and program pages

    Help stakeholders find the schedule, decisions, risks or contacts on a page that covers a whole project.

  • Onboarding material

    Turn a new employee guide into sections people can come back to during their first weeks.

Best practices

  • Add the web part to the first section of the page, next to or just above the start of the content.
  • Structure the page with heading styles (Heading 1 to Heading 4 in the Text web part), not bold or enlarged text, so every section is listed.
  • Keep headings short and descriptive. On long documents, numbering them, as in “3. Definitions”, helps readers keep their bearings.
  • List one or two heading levels on long pages, so the table of contents stays easy to scan.
  • Choose Left or Right on pages that take several screens to read, and In place on shorter ones.
  • Add a back button that leads to the page listing related pages, such as all your policies or guides.

Release notes

  1. Initial release

    October 2026

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

Support

Have a question about CNX On this page, 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.