Syncing Rules

Syncing rules define what content from OneNote gets copied into Confluence, and where it appears. Each rule is based on a OneNote notebook and creates pages that mirror your notebook’s structure.

🧩 Current Capabilities

At this stage, syncing rules allow you to:

  • Select an entire OneNote notebook

  • Choose a Confluence space as the target

  • Optionally define a parent page

  • Automatically keep content up to date in Confluence

🔄 How Syncing Works

  • Rules are evaluated every few minutes

  • The system checks if there are:

    • New pages in the notebook

    • Changes to existing pages since the last sync

  • If updates are found, the corresponding Confluence pages are created or overwritten

⚠️ One-way sync only:
Changes in OneNote will overwrite Confluence content. Changes made in Confluence will be lost on the next sync.

🧱 Notebook Structure in Confluence

OneNote notebooks have a nested structure:

  • Notebook

    • Section Group (optional, acts like a folder)

      • Section (acts like a folder)

        • Pages

This structure is replicated in Confluence using:

  • Pages and sub-pages under a defined Parent Page

  • (Planned: Use of folders for cleaner structure with SectionGroups → Pages → Sub-pages)

💡 Example Mapping

OneNote Confluence Output
Notebook: Project X → Space: Projects, Parent Page: Project X
Section Group: Notes → Page: Notes
Section: Meetings → Page: Meetings (child of Notes)
Page: Kickoff → Page: Kickoff (child of Meetings)

⚙️ What You Can Configure

Option Description
Notebook The source OneNote notebook to sync
Space The Confluence space to sync into
Parent Page Optional root page under which all synced content is created
(Planned) Prefixing or customizing page titles, folder-like grouping for sections

🌐 Shared Notebooks (Preview)

We are beginning to support shared notebooks, specifically those hosted via:

  • ✅ OneDrive (supported)

  • ❌ SharePoint (not yet supported)

🧠 Although Microsoft treats OneDrive and SharePoint as a unified experience, they are still technically separate services under the hood. Support for SharePoint-based notebooks is on our roadmap.

We'll publish a dedicated article explaining how to work with shared notebooks and which types are currently compatible.

🚧 Limitations (Current Version)

  • Only entire notebooks can be synced (no section-level selection yet)

  • No custom sync frequency (runs automatically every few minutes)

  • No filtering by tags, modified date, or user

  • Confluence updates are overwritten by OneNote during sync

  • No UI-based sync trigger (rules run in background only)

🔮 Planned Features

We are working on:

  • Section/page-level sync

  • Use of folders to mirror OneNote structure more cleanly

  • Custom page titles and title prefixes

  • UI for pausing, editing, or manually triggering syncs

  • Support for SharePoint-based shared notebooks

  • And many more!