  {"id":2637,"date":"2024-01-31T14:23:31","date_gmt":"2024-01-31T19:23:31","guid":{"rendered":"https:\/\/carleton.ca\/cutheme-docs\/?page_id=2637"},"modified":"2026-08-10T21:00:22","modified_gmt":"2026-08-11T01:00:22","slug":"table-of-contents","status":"publish","type":"page","link":"https:\/\/carleton.ca\/cutheme-docs\/intermediate-training\/intermediate-training-module-2-common-content-blocks\/table-of-contents\/","title":{"rendered":"Table of Contents"},"content":{"rendered":"\n<section class=\"w-screen px-6 cu-section cu-section--white ml-offset-center md:px-8 lg:px-14\">\n    <div class=\"space-y-6 cu-max-w-child-5xl  md:space-y-10 cu-prose-first-last\">\n\n            <div class=\"cu-textmedia flex flex-col lg:flex-row mx-auto gap-6 md:gap-10 my-6 md:my-12 first:mt-0 max-w-5xl\">\n        <div class=\"justify-start cu-textmedia-content cu-prose-first-last\" style=\"flex: 0 0 100%;\">\n            <header class=\"font-light prose-xl cu-pageheader md:prose-2xl cu-component-updated cu-prose-first-last\">\n                                    <h1 class=\"cu-prose-first-last font-semibold !mt-2 mb-4 md:mb-6 relative after:absolute after:h-px after:bottom-0 after:bg-cu-red after:left-px text-3xl md:text-4xl lg:text-5xl lg:leading-[3.5rem] pb-5 after:w-10 text-cu-black-700 not-prose\">\n                        Table of Contents Block\n                    <\/h1>\n                \n                                \n                                    \n\n<p class=\"wp-block-paragraph\">Intermediate Training Module 2: Common Content Blocks<\/p>\n\n\n                            <\/header>\n\n                    <\/div>\n\n            <\/div>\n\n    <\/div>\n<\/section>\n\n\n\n<p class=\"wp-block-paragraph\">The Table of Contents block automatically creates a navigational menu based on the headings used on a page. It is one of the easiest ways to improve navigation on longer pages and help visitors find information more quickly.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">As headings are added, removed, or updated, the Table of Contents updates automatically. This makes it an ideal solution for pages containing large amounts of content, such as guides, policies, FAQs, and training materials.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">You&#8217;ll notice that many pages throughout this training site use a Table of Contents to help readers jump directly to the sections they&#8217;re interested in.<\/p>\n\n\n\n<h2 id=\"when-to-use-a-table-of-contents\" class=\"wp-block-heading\">When to Use a Table of Contents<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">A Table of Contents is most useful on pages that contain multiple sections or a significant amount of content.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Common examples include:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Training modules<\/li>\n\n\n\n<li>Documentation pages<\/li>\n\n\n\n<li>Policies and procedures<\/li>\n\n\n\n<li>FAQ collections<\/li>\n\n\n\n<li>Resource guides<\/li>\n\n\n\n<li>Long-form content<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">For shorter pages with only one or two sections, a Table of Contents is usually unnecessary.<\/p>\n\n\n\n<h2 id=\"how-the-table-of-contents-works\" class=\"wp-block-heading\">How the Table of Contents Works<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The block automatically generates links based on the headings that appear below it on the page.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Typically:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>H2 headings<\/strong> become top-level items.<\/li>\n\n\n\n<li><strong>H3 headings<\/strong> appear as sub-items beneath the relevant H2 heading.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">For example:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>Introduction (H2)\nGetting Started (H2)\n    Creating Content (H3)\n    Publishing Content (H3)\nAdditional Resources (H2)<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Would automatically generate a navigation menu based on that structure.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Because it relies on headings, using proper Heading blocks and heading hierarchy is important.<\/p>\n\n\n\n<h2 id=\"adding-a-table-of-contents\" class=\"wp-block-heading\">Adding a Table of Contents<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">To add a Table of Contents:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Click the <strong>+<\/strong> button and search for <strong>Table of Contents<\/strong>.<\/li>\n\n\n\n<li>Select the Table of Contents block.<\/li>\n\n\n\n<li>Place it where you want the navigation menu to appear.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">That&#8217;s it!<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The block will automatically build itself using the headings that follow it on the page.<\/p>\n\n\n\n<h2 id=\"block-placement\" class=\"wp-block-heading\">Block Placement<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The position of the Table of Contents matters.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The block will generate links based on the headings that appear below it in the page structure.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">For this reason, it is usually placed:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Near the top of the page<\/li>\n\n\n\n<li>Below the page introduction<\/li>\n\n\n\n<li>Before major content sections<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">This allows visitors to immediately see all available sections and navigate directly to them.<\/p>\n\n\n\n<h2 id=\"heading-structure-matters\" class=\"wp-block-heading\">Heading Structure Matters<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The quality of a Table of Contents depends on the quality of your heading structure.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Good Example:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>H2 Admissions\n    H3 Applying\n    H3 Deadlines\nH2 Tuition\n    H3 Fees\n    H3 Scholarships<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Less Effective Example<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>H2 Admissions\n    H4 Applying\nH2 Tuition\n    H5 Fees<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Using proper heading levels creates a clearer and more accessible navigation experience.<\/p>\n\n\n\n<h2 id=\"benefits-of-using-a-table-of-contents\" class=\"wp-block-heading\">Benefits of Using a Table of Contents<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong class=\"myprefix-text-bold\">Improved Navigation<\/strong><br>Visitors can jump directly to relevant sections without scrolling through the entire page.<\/li>\n\n\n\n<li><strong class=\"myprefix-text-bold\">Better User Experience<\/strong><br>Large pages become easier to browse and understand.<\/li>\n\n\n\n<li><strong class=\"myprefix-text-bold\">Automatic Updates<\/strong><br>As headings change, the Table of Contents updates automatically.<\/li>\n\n\n\n<li><strong class=\"myprefix-text-bold\">Encourages Better Page Structure<\/strong><br>Using a Table of Contents reinforces the importance of clear heading hierarchy and accessible content organization.<\/li>\n<\/ul>\n\n\n\n<h2 id=\"best-practices\" class=\"wp-block-heading\">Best Practices<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\"><strong class=\"myprefix-text-bold\">Use on Longer Pages<\/strong><br>A Table of Contents provides the greatest value on pages with several sections.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong class=\"myprefix-text-bold\">Use Descriptive Headings<\/strong><br>Visitors should be able to understand what each section contains based on the heading alone.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Good Examples:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Admission Requirements<\/li>\n\n\n\n<li>Contact Information<\/li>\n\n\n\n<li>Frequently Asked Questions<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Avoid:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Details<\/li>\n\n\n\n<li>More Information<\/li>\n\n\n\n<li>Section 1<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong class=\"myprefix-text-bold\">Follow Heading Hierarchy<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Use headings in a logical order: <code>h2, h3, h4<\/code>. This creates a cleaner navigation structure.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong class=\"myprefix-text-bold\">Place It Near the Top<\/strong><br>Users should be able to see the Table of Contents before they begin scrolling through the page.<\/p>\n\n\n\n<figure class=\"wp-block-embed alignwide is-type-video is-provider-youtube wp-block-embed-youtube wp-embed-aspect-16-9 wp-has-aspect-ratio w-screen ml-offset-center cu-max-w-child-7xl px-4 md:px-6 lg:px-12\"><div class=\"wp-block-embed__wrapper\">\n<iframe loading=\"lazy\" title=\"cutheme Mastery Training - Table of Contents\" width=\"500\" height=\"281\" src=\"https:\/\/www.youtube.com\/embed\/d49otxQCruM?feature=oembed\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" referrerpolicy=\"strict-origin-when-cross-origin\" allowfullscreen><\/iframe>\n<\/div><\/figure>\n\n\n\n<section class=\"w-screen px-6 cu-section cu-section--white ml-offset-center md:px-8 lg:px-14\">\n    <div class=\"space-y-6 cu-max-w-child-5xl  md:space-y-10 cu-prose-first-last\">\n\n        \n    \n    <dl class=\"cu-description cu-component-updated\">\n        \n    <div class=\"grid pt-4 pb-3 border-b accordion border-cu-black-100 md:pt-6 md:pb-5 first:border-t\">\n        <dt class=\"font-semibold not-prose\">\n            <button class=\"flex items-center justify-between w-full text-left accordion__button\" aria-expanded=\"false\" aria-controls=\"accordion-transcript-table-of-contents\">\n                <span class=\"flex-1 ml-auto text-left break-words whitespace-normal cu-icon\">\n                    Transcript \u2013 Table of Contents\n                <\/span>\n                <svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" fill=\"none\" viewbox=\"0 0 24 24\" stroke-width=\"1.5\" stroke=\"currentColor\" aria-hidden=\"true\" data-slot=\"icon\" class=\"w-5 h-5 ml-auto transition-transform rotate-0 accordion__icon text-cu-black-500\">\n                    <path stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M8.25 4.5l7.5 7.5-7.5 7.5\"><\/path>\n                <\/svg>\n            <\/button>\n        <\/dt>\n        <dd class=\"p-0 mt-0 cu-prose cu-prose-first-last accordion__content md:p-0 md:mt-0\" hidden=\"\" id=\"accordion-transcript-table-of-contents\">\n            \n\n<p class=\"wp-block-paragraph\">In this video, we are going to explore using the Table of Contents block in your pages.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">This is especially helpful in very long, or content heavy pages, where one may need to scroll a lot, or parse through a lot of information, just to find what they need.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Adding a table of contents to your page is very simple.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">When you are in your page editor, navigate to the block menu and click on the table of contents block.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">And once its on your page, you can move it around to anywhere you like.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">One thing to keep in mind is that this block sorts information using the H2 and H3 header levels. H2 being the top level. And H3 being the second level.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">By finishing those steps, we have now successfully added a Table of Contents to a page.<\/p>\n\n\n        <\/dd>\n    <\/div>\n\n\n    <\/dl>\n\n\n    <\/div>\n<\/section>\n\n\n\n<h2 id=\"try-it-out\" class=\"wp-block-heading\">Try it Out<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Practice using the Table of Contents block.<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Create a page with several Heading blocks.<\/li>\n\n\n\n<li>Add a Table of Contents block near the top of the page.<\/li>\n\n\n\n<li>Preview the page.<\/li>\n\n\n\n<li>Click the items in the Table of Contents to navigate between sections.<\/li>\n\n\n\n<li>Add a new H2 or H3 heading and observe how the Table of Contents updates automatically.<\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"<p>Automatically generate page navigation from headings to help visitors find information on longer pages.<\/p>\n","protected":false},"author":3,"featured_media":0,"parent":5167,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"_cu_dining_location_slug":"","footnotes":"","_links_to":"","_links_to_target":""},"cu_page_type":[61],"class_list":["post-2637","page","type-page","status-publish","hentry","cu_page_type-intermediate-training-module-2"],"acf":{"cu_post_thumbnail":""},"_links":{"self":[{"href":"https:\/\/carleton.ca\/cutheme-docs\/wp-json\/wp\/v2\/pages\/2637","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/carleton.ca\/cutheme-docs\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/carleton.ca\/cutheme-docs\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/carleton.ca\/cutheme-docs\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/carleton.ca\/cutheme-docs\/wp-json\/wp\/v2\/comments?post=2637"}],"version-history":[{"count":5,"href":"https:\/\/carleton.ca\/cutheme-docs\/wp-json\/wp\/v2\/pages\/2637\/revisions"}],"predecessor-version":[{"id":4255,"href":"https:\/\/carleton.ca\/cutheme-docs\/wp-json\/wp\/v2\/pages\/2637\/revisions\/4255"}],"up":[{"embeddable":true,"href":"https:\/\/carleton.ca\/cutheme-docs\/wp-json\/wp\/v2\/pages\/5167"}],"wp:attachment":[{"href":"https:\/\/carleton.ca\/cutheme-docs\/wp-json\/wp\/v2\/media?parent=2637"}],"wp:term":[{"taxonomy":"cu_page_type","embeddable":true,"href":"https:\/\/carleton.ca\/cutheme-docs\/wp-json\/wp\/v2\/cu_page_type?post=2637"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}