How to Add and Customize a Page Tree in Your Confluence Sidebar When managing a growing knowledge base, navigation is everything. If your team can’t find the right documentation, the information might as well not exist. One of the most effective ways to organize content is by adding a Page Tree to your Confluence sidebar. In this guide, we’ll walk through how to enable, configure, and troubleshoot the page tree to ensure your workspace remains intuitive and easy to navigate. What is a Confluence Page Tree? A Page Tree is a hierarchical representation of the pages within a specific Confluence space. It displays pages as a nested list, allowing users to expand or collapse parent pages to reveal child pages. By default, Confluence Cloud and Data Center usually include a page tree in the sidebar, but it can be customized, hidden, or replaced depending on your space's specific needs. How to Add or Enable the Page Tree in the Sidebar If you notice your sidebar is missing its navigation hierarchy, follow these steps to bring it back: 1. Access Space Settings Navigate to the space where you want to manage the sidebar. Click on Space settings in the bottom-left corner of the sidebar. 2. Configure Sidebar Look and Feel Depending on your Confluence version (Cloud vs. Data Center), the menu labels might differ slightly: Confluence Cloud: Go to Space settings > Content tools > Sidebar, header and footer . Confluence Data Center/Server: Go to Space tools > Configure sidebar . 3. Toggle the Page Tree In the sidebar configuration menu, you will see a section for "Hierarchy" or "Page Tree." Ensure the toggle is switched to On or Visible . This will automatically generate a dynamic list of every page in that space. Customizing Your Sidebar Navigation Sometimes, a simple list of every page is too cluttered. You can refine your sidebar to make it more user-friendly: Using the "Shortcut" Feature If you have specific high-traffic pages, don't rely solely on the page tree. Use the + Add Shortcut button in the sidebar. This allows you to pin essential pages (like a "Team Onboarding" or "Project Roadmap" page) above the main tree for instant access. Hiding Specific Pages The standard sidebar page tree shows everything . If you want to hide certain pages from the general hierarchy, you must either: Move those pages to a different space. Restrict page viewing permissions (though this is not recommended purely for UI cleanup). Use the Advanced Sidebar options to switch to a "Manual" navigation mode where you hand-pick which links appear. Using the Page Tree Macro on a Page While the sidebar is the most common place for a page tree, you might also want to embed a tree directly on a landing page. Type /page tree (in Cloud) or {pagetree} (in Legacy/Data Center) while editing a page. Configure the parameters: Root Page: Choose where the tree starts (e.g., only show sub-pages of the "Engineering" folder). Search Box: Enable a search bar above the tree for quick filtering. Expand/Collapse: Choose whether the tree starts fully expanded or closed. Troubleshooting: Why is my Page Tree missing? If you've followed the steps above and the tree still isn't showing, check the following: Permissions: You must be a Space Administrator to modify sidebar settings. Global Theme vs. Documentation Theme: If you are on an older version of Confluence Data Center using the "Documentation Theme," the sidebar behaves differently. Most modern instances use the "Global Theme," which supports the standard sidebar toggle. Collapsed Sidebar: Sometimes the sidebar itself is collapsed to a thin strip. Click the >> icon at the bottom left to expand it. Adding a page tree to your Confluence sidebar is the first step toward a "Single Source of Truth" that actually works. By combining a clean hierarchy with strategic shortcuts, you can reduce the "where is that document?" messages and keep your team focused on the work that matters.
Title: Architecting Information: The Strategic Implementation of Page Trees in the Confluence Sidebar Introduction In the modern digital workspace, information is the currency of productivity. However, information without organization is merely noise. Atlassian Confluence stands as a premier enterprise wiki and collaboration tool, designed to house vast repositories of institutional knowledge. Yet, the default configuration of Confluence often presents a linear, blog-style layout that can obscure hierarchical documentation. To unlock the full potential of Confluence as a structured knowledge base, administrators and space architects must leverage the "Page Tree." Integrating a page tree into the sidebar transforms a chaotic collection of pages into a navigable, intuitive library. This essay explores the technical implementation of the page tree, its psychological impact on user navigation, and its pivotal role in establishing a sustainable Information Architecture (IA). The Case for Hierarchy: Why the Sidebar Matters Before examining the "how," it is essential to understand the "why." The default Confluence sidebar is functional but often limited. It typically displays a list of "Pages" in the order they were last updated, a chronological approach that fails to represent the logical relationship between documents. For a project management space, a standard operating procedure (SOP) manual, or a technical knowledge base, chronological order is insufficient. Users require context. They need to know that "Login Authentication" is a child of "Security Protocols," which is a child of "System Architecture." By moving the page tree to the sidebar, organizations provide users with a "bird’s-eye view" of the content. This reduces the cognitive load on the user; they no longer have to rely on search bars or breadcrumbs to understand where they are within the documentation hierarchy. The sidebar becomes a map, allowing for rapid "pogo-sticking"—the act of jumping between related pages without returning to a root directory. Technical Implementation: The "Pages" Option The most direct method to add a page tree to the sidebar is through Confluence’s native space configuration settings. This process has been streamlined by Atlassian in recent updates, specifically through the "Pages" feature. Historically, users relied on the "Page Tree" macro within a custom sidebar. Today, the standard approach involves enabling the "Pages" section in the sidebar configuration. To achieve this, a space administrator navigates to Space Settings > Overview > Sidebar . Here, the interface allows for the customization of the sidebar header and the arrangement of links. By adding or prioritizing the "Pages" link, Confluence automatically renders the hierarchical page tree. Crucially, this native implementation is dynamic. It respects the page hierarchy established in the space. If a user creates a parent page and indents child pages beneath it, the sidebar reflects this structure immediately. Furthermore, this method supports permissions; users will only see pages in the tree that they have permission to view, ensuring security is maintained alongside accessibility. Advanced Customization: The Custom Sidebar Approach While the native "Pages" option is robust, some organizations require granular control that the default settings cannot provide. For instance, a user may wish to display a specific subset of pages or embed the tree within a larger dashboard context. This is where the "Custom Sidebar" approach comes into play. By selecting "Custom sidebar" in the settings, administrators can point the sidebar to a specific Confluence page. On this designated page, they can utilize the {pagetree} macro. This macro allows for specific parameters, such as setting a "Root Page." This is particularly useful for large spaces where the root of the space is a generic homepage, but the documentation actually begins three levels down. By setting a specific root page in the macro, the sidebar tree can be trimmed to show only the relevant documentation branch, decluttering the user interface. Additionally, the {pagetreesearch} macro can be added to this custom sidebar page, providing a localized search function that filters the tree instantly. This combination creates a powerful, app-like navigation experience directly within the wiki interface. The Imperative of Information Architecture Adding a page tree to the sidebar is not merely a cosmetic adjustment; it is a discipline of Information Architecture. The effectiveness of the page tree is entirely dependent on the quality of the hierarchy it displays. A "flat" structure—where fifty pages all sit at the root level—renders a page tree useless, creating an endless scrolling list. Therefore, the implementation of a sidebar page tree must be accompanied by a governance strategy. Space administrators must enforce a parent-child structure. This often involves creating "Container Pages" that serve as section headers (e.g., "Meeting Notes," "Technical Specs," "Team Roster") and ensuring all content is nested appropriately. When this structure is maintained, the sidebar page tree becomes a visual representation of the organization's workflow and logic, making the platform self-explanatory to new hires and external stakeholders. Conclusion The integration of a page tree into the Confluence sidebar is a critical step in maturing a collaborative environment from a simple file dump into a sophisticated knowledge management system. By utilizing the native "Pages" configuration or deploying advanced custom sidebar macros, administrators can drastically improve content discoverability. However, the tool is only as effective as the strategy behind it. A well-structured page tree reflects a well-organized mind—or organization—turning the Confluence space into an intuitive, navigable asset rather than a labyrinth of lost documents. In the quest for operational efficiency, the sidebar page tree is not just a feature; it is a foundational pillar of digital structure.
In Confluence, the page tree is typically visible by default in the sidebar, but its appearance can vary depending on your site's theme and version. If it is missing or you wish to customize it, you can use the following methods. 1. Standard Sidebar Configuration For most Confluence Cloud and Data Center instances, you can manage the visibility of the native page tree through space settings. Access Sidebar Settings : Click Space tools (bottom of the sidebar) > Configure sidebar . Show/Hide Page Tree : Use the eye icons to toggle the visibility of the default page tree. Set Space Homepage : Ensure a Space Homepage is set. If no homepage is defined, the page tree may not appear at all. 2. Add a Custom Page Tree via Sidebar Macro If you want a more customized tree (e.g., specific root page, search box, or specific depth), you can add the Page Tree Macro directly into the sidebar's "Sidebar, Header and Footer" section. Navigate to Space tools > Look and Feel > Sidebar, Header and Footer . In the Sidebar text box, enter the following macro code: {pagetree:sort=natural|searchBox=true|expandCollapseAll=true} Save the changes. This custom tree will now appear above the default sidebar links. 3. Troubleshooting Missing Page Trees If the sidebar appears empty or is missing the tree: Collapse/Expand : Hover over the right edge of the sidebar; an arrow may appear to expand the content if it was collapsed. Reorder Pages : Check Space Tools > Content Tools > Reorder Pages . If pages are not nested under a root "Home" page, they may not display correctly in the hierarchical tree. Check for Custom Code : Custom CSS or Javascript added to the Global Stylesheet can sometimes accidentally hide sidebar elements like the .main-links-section . Comparison of Methods How to add a page tree in the sidebar in the new cloud design
Use the Page Tree macro to add a Page Tree to the sidebar instead. Steps. To hide the other default options from the sidebar. Add ... Atlassian Support Organize and customize your Confluence space - Atlassian Organize and customize your Confluence space * Use parent & child pages - With a few clicks, create a content hierarchy that's vis... Atlassian Insert the content tree macro | Confluence Cloud - Atlassian Support To add the content tree macro: * When editing, select from the toolbar. * Find the macro by name and select it. * Configure it as ... Atlassian Support How can I get my content tree to show on the sidebar? May 17, 2024 — confluence add page tree to sidebar
Here’s a deep, technical, and user-focused write-up on the topic: Adding a Page Tree to the Sidebar in Confluence .
Mastering Navigation: A Deep Dive into Adding a Page Tree to the Confluence Sidebar Introduction: Why the Sidebar Page Tree Matters Confluence, by design, thrives on hierarchical organization. Spaces contain pages, pages contain child pages, and those contain further sub-pages. However, as a space grows beyond a few dozen pages, users often face a common problem: "Where did that important sub-page go?" The default Confluence sidebar displays recent pages, popular pages, and space shortcuts. While useful for quick access, it fails to show the structural context of your documentation. This is where the Page Tree macro—placed directly into the sidebar—becomes a transformative solution. Adding a page tree to the sidebar turns your Confluence space into a fully navigable document hierarchy, mirroring the experience of a file system or a wiki index. This write-up explores the why , how , and best practices of this configuration.
The Core Concept: Page Tree Macro in the Sidebar Confluence provides a native macro called Page Tree . Its function is simple: display a dynamic, collapsible tree view of all pages under a specified parent page. When embedded in the sidebar (a persistent left-hand panel in modern Confluence Cloud and Data Center), the page tree becomes a global navigation menu. Every click expands or collapses a branch, and every page title becomes a direct link. Native vs. Third-Party Approaches How to Add and Customize a Page Tree
Confluence Cloud / Data Center (native): You can add macros to the sidebar by editing the sidebar content via Space Settings > Look and Feel > Sidebar . Here, you insert the {page-tree} macro. Third-party apps (e.g., Refined, Scroll Viewport, Handy Macros): These offer enhanced tree features like custom icons, sorting, filtering, and external page linking. For most teams, the native macro is sufficient.
Step-by-Step Implementation (Confluence Cloud) Prerequisites
Space admin permissions. A logical parent page (usually the space homepage or a "root" documentation page). In this guide, we’ll walk through how to
Procedure
Navigate to your Space → Click Space Settings (bottom left sidebar). Under Look and Feel , select Sidebar . Click Edit Sidebar (pencil icon). In the sidebar editor, position your cursor where you want the tree (e.g., below the "Space shortcuts" or "Navigation" heading). Type {page-tree and select the macro from the autocomplete menu. Configure the macro parameters: