Navitabs - Navigation Macros for Confluence Cloud
Breadcrumbs

Building a Product Knowledge Hub for a Software Company

System

Confluence Cloud

Short description

Improve the navigation and usability of product documentation spaces in Confluence by using Navitabs' new Cards layout, updated tab styles, and advanced design customization. This will make it easier for teams to find and interact with content.

Challenge

Content creators often struggle with presenting large or complex documentation in a structured and engaging way. Traditional long-scroll Confluence pages or inconsistent tab usage can overwhelm users, leading to confusion, longer search times, and reduced adoption of internal knowledge spaces. These challenges impact various teams—sales, support, and marketing—who rely on quick access to clear, up-to-date information.

Actors

📝 Jamie – Content Creator / Knowledge Manager
📣 Marc – Marketing Specialist
💼 Jordan – Sales & Account Executive
💻 Rita – IT Support Specialist

Actors Goals

  • Jamie wants to redesign the product documentation hub to be more user-friendly, maintainable, and aligned with the company’s brand.

  • Marc and Jordan want quick access to marketing and feature information in a visually intuitive way before client-facing meetings.

  • Rita wants to find setup and troubleshooting information quickly, without scrolling through disorganized pages.

Implementation Details

  • Install or update Navitabs - Navigation Macros for Confluence.

  • Use the Tab Wizard macro editor on any Confluence page to choose the new Cards navigation type.

  • Populate each card with an image, title, and description to represent key content areas or product spaces.

  • Applying the new Round Tabs or Square Tabs within product pages depends on the content type.

  • Use the Tab Design to create, modify, or personalize tab designs.

  • Reuse custom designs across pages and spaces to maintain visual consistency.

  • No development effort required—changes are fully configurable through the Confluence UI.

  • Tab and card designs can be easily adjusted and previewed live before publishing.

Use Case Scenario (step-by-step)

  1. Jamie updates Navitabs to the latest version in Confluence Cloud.

  2. She creates a new page for the product knowledge hub using the Cards navigation type—each card features a product name, logo, and short description.

  3. Jamie links each card to a dedicated product space (e.g., “Product Alpha”), where she uses Round Tabs to organize key sections: Overview, Features, Release Notes, FAQs.

  4. For more technical internal documentation, Jamie applies the Square Tabs style for a structured, professional layout.

  5. She customizes tab styles that align with company branding, modifies the default designs, and removes outdated ones.

  6. When Marc and Jordan need quick talking points or release notes, they access the Cards page, select a product, and immediately see a clean, organized layout with all key content tabbed.

  7. Responding to a colleague's question, Rita uses the tabs to jump straight to setup instructions without scrolling through a long page.

Outcome

  • Jamie delivers a more polished and brand-aligned knowledge hub that’s easier to maintain and scale.

  • Marc and Jordan spend less time hunting for information and more time preparing for effective client engagements.

  • Rita can resolve internal questions and support issues faster, improving productivity.

  • The company benefits from a more consistent, user-friendly documentation experience that improves onboarding, support resolution times, and cross-team communication.