Skip to content
API Reference

Sync Confluence

Version: unreleased · Docs: 3c6ab9f2Download Markdown

The Confluence connector imports selected content into Knowledge so you can use it in threads and workflows. Connecting an account and importing content are separate steps. This guide covers the connector, rather than individual plugin actions.

You need access to the source spaces and pages, permission to create a connection in the current workspace, and an available Confluence provider in your deployment. An administrator must configure an unavailable provider before you can connect it.

Select a source on Customize → Connectors; setup icons reflect this deployment’s availability.

  1. Open Knowledge, then Connectors, and choose Confluence.
  2. Complete the offered sign-in using the account that can access your content.
  3. Return to Redbelt and choose the source content to sync.
  4. Review the selected scope and any offered file filters.
  5. Open the import preview and inspect its files, folders, and estimated size.
  6. Check any listed removals before approving changes to an existing selection.
  7. Click Start sync and confirm that the connection shows the requested run.

Select spaces or top-level pages. Set Page depth to control how far child pages are included, from one to five levels. Review Pages, Attachments, Blog posts, and Comments separately; selecting a space does not mean every content category is enabled.

After the run finishes, open a resulting file in Knowledge and check its content against the source. A connected account alone does not establish a completed import. The preview is a snapshot: source content can change before the import runs.

Use Configure from your connections list to revisit the connection. For folder-based connections, Change folders changes the selected scope. Sync now requests another run; Automatic sync controls scheduled updates. Check the most recent run and any failures when content appears stale.

If pages are missing, check the selected space, top-level page, page-depth limit, and content options. Confirm that the connected Atlassian account can read the pages.

Pausing automatic sync stops scheduled refreshes; it does not remove already imported content. Read the confirmation carefully when disconnecting or removing a connection: Remove connection and content… also removes its imported content.

Related: use Knowledge in a thread, organize Knowledge, and sharing.