blog posts serve different structural purposes. While standard pages thrive in a hierarchical tree view, blog posts are strictly chronological. Below is a draft for a Confluence blog post that explains this distinction and provides tips for organizing your content. Blog Post: Untangling the Tree – Pages vs. Blogs in Confluence Have you ever wondered why you can't "nest" your blog posts like you do with your project pages? You aren't alone! One of the most common questions from new Confluence users is how to manage the "tree view" for different types of content. 🌳 The Page Tree: Your Content's Backbone Standard
Confluence Tree View: The Ultimate Guide to Visual Hierarchy & Content Architecture 1. What is a Confluence Tree View? In Confluence (Cloud, Data Center, or Server), a Tree View is a hierarchical, expandable/collapsible sidebar or macro that displays the nested structure of pages within a Space or a specific parent page. Unlike the flat "Recently Updated" view or a simple list of child pages, a Tree View visualizes parent-child-grandchild relationships—mimicking a file system or a mind map. Key Characteristics:
Indentation: Deep pages are visually indented. Expand/Collapse Nodes: Click the > or v icon to reveal sub-pages. Dynamic Linking: Each node is a clickable link. Scope: Can show a single branch (starting from one page) or the entire Space.
2. Why Use a Tree View? (Problem vs. Solution) | Problem | Solution via Tree View | |--------|------------------------| | Users get lost in 100+ flat pages | Visual orientation: "Where am I?" | | Related docs are not linked | Shows logical containment (e.g., Product > Features > API ) | | New hires can't find the source of truth | Provides a single, scannable table of contents | | Cross-referencing is manual | Tree serves as a live, auto-updating map | Best for: Documentation hubs, product requirements (PRDs), knowledge bases, onboarding guides, and legal repositories. 3. How to Create a Tree View in Confluence Confluence does not have a native, dedicated "Tree View macro" out-of-the-box (except legacy Page Tree macro). However, you can build one using these methods: Method A: Built-in "Page Tree" Macro (Legacy & Cloud) confluence tree view
Edit a page. Type /pagetree (or /page tree ). Configure:
Root Page: The starting page (e.g., "Company Wiki" or "Product Hub"). Expand All? (Usually "No" to avoid overload). Sort by: Title, creation date, or manual order. Show Child Pages Only? (Hides the root itself).
Method B: "Children Display" Macro (Simpler, Flat) blog posts serve different structural purposes
Shows only direct children , not grandchildren. Use when you only need one level.
Method C: Third-Party Add-ons (Advanced) For true, file-explorer-style tree with icons, drag-drop reorder, and custom root:
Refined Toolkit (Cloud/DC) – "Navigation Tree" Content Formatting Macro for Confluence Bob Swift’s CLI (legacy) Blog Post: Untangling the Tree – Pages vs
4. Anatomy of a Well-Designed Tree View A powerful tree view follows Information Architecture (IA) principles: Root Page (The Trunk)
Should be a landing page with an intro and links. Example: 📘 Employee Handbook
blog posts serve different structural purposes. While standard pages thrive in a hierarchical tree view, blog posts are strictly chronological. Below is a draft for a Confluence blog post that explains this distinction and provides tips for organizing your content. Blog Post: Untangling the Tree – Pages vs. Blogs in Confluence Have you ever wondered why you can't "nest" your blog posts like you do with your project pages? You aren't alone! One of the most common questions from new Confluence users is how to manage the "tree view" for different types of content. 🌳 The Page Tree: Your Content's Backbone Standard
Confluence Tree View: The Ultimate Guide to Visual Hierarchy & Content Architecture 1. What is a Confluence Tree View? In Confluence (Cloud, Data Center, or Server), a Tree View is a hierarchical, expandable/collapsible sidebar or macro that displays the nested structure of pages within a Space or a specific parent page. Unlike the flat "Recently Updated" view or a simple list of child pages, a Tree View visualizes parent-child-grandchild relationships—mimicking a file system or a mind map. Key Characteristics:
Indentation: Deep pages are visually indented. Expand/Collapse Nodes: Click the > or v icon to reveal sub-pages. Dynamic Linking: Each node is a clickable link. Scope: Can show a single branch (starting from one page) or the entire Space.
2. Why Use a Tree View? (Problem vs. Solution) | Problem | Solution via Tree View | |--------|------------------------| | Users get lost in 100+ flat pages | Visual orientation: "Where am I?" | | Related docs are not linked | Shows logical containment (e.g., Product > Features > API ) | | New hires can't find the source of truth | Provides a single, scannable table of contents | | Cross-referencing is manual | Tree serves as a live, auto-updating map | Best for: Documentation hubs, product requirements (PRDs), knowledge bases, onboarding guides, and legal repositories. 3. How to Create a Tree View in Confluence Confluence does not have a native, dedicated "Tree View macro" out-of-the-box (except legacy Page Tree macro). However, you can build one using these methods: Method A: Built-in "Page Tree" Macro (Legacy & Cloud)
Edit a page. Type /pagetree (or /page tree ). Configure:
Root Page: The starting page (e.g., "Company Wiki" or "Product Hub"). Expand All? (Usually "No" to avoid overload). Sort by: Title, creation date, or manual order. Show Child Pages Only? (Hides the root itself).
Method B: "Children Display" Macro (Simpler, Flat)
Shows only direct children , not grandchildren. Use when you only need one level.
Method C: Third-Party Add-ons (Advanced) For true, file-explorer-style tree with icons, drag-drop reorder, and custom root:
Refined Toolkit (Cloud/DC) – "Navigation Tree" Content Formatting Macro for Confluence Bob Swift’s CLI (legacy)
4. Anatomy of a Well-Designed Tree View A powerful tree view follows Information Architecture (IA) principles: Root Page (The Trunk)
Should be a landing page with an intro and links. Example: 📘 Employee Handbook