> ## Documentation Index
> Fetch the complete documentation index at: https://docs.duckie.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Confluence

> Sync Confluence spaces and pages to your Duckie knowledge base

Connect Confluence to sync your team's documentation and knowledge base.

## Capabilities

| Capability             | Supported               |
| ---------------------- | ----------------------- |
| **Knowledge Source**   | ✓ Sync spaces and pages |
| **Deployment Trigger** | ✗                       |
| **Tool Actions**       | ✗                       |

## Setup

### Connect via OAuth

1. Go to **Settings → Connections** in Duckie
2. Find **Confluence** and click **Connect**
3. You'll be redirected to Atlassian
4. Select the Confluence site to connect
5. Authorize Duckie's access
6. You'll be redirected back to Duckie

<Info>
  Duckie requests read-only access to your Confluence content.
</Info>

## Selecting Content to Sync

After connecting:

1. Go to **Train → Knowledge**
2. Click **Add Source**
3. Select **Confluence**
4. Choose what to sync:
   * **Entire spaces**: Sync all pages in selected spaces
   * **Specific pages**: Pick individual pages or page trees

### What Gets Synced

* Page content (text, formatted content)
* Page attachments (PDFs, images)
* Blog posts
* Page labels (used for tagging)
* Nested/child pages

### What Doesn't Sync

* Comments
* Page history
* Restricted pages (based on your permissions)

## Best Practices

### Sync Support-Relevant Spaces

Focus on spaces that help answer customer questions:

* Product documentation
* How-to guides
* FAQ pages
* Troubleshooting guides

### Use Space Permissions

Your Confluence permissions apply — Duckie only sees what you can see. Connect with an account that has access to relevant spaces.

### Leverage Labels

Use Confluence labels to organize content:

* Label pages by topic or product
* Use labels to filter what gets synced
* Helps with knowledge organization in Duckie

## Sync Frequency

* **Automatic sync**: Every few hours
* **Manual sync**: Click "Sync Now" in Knowledge sources
* **Change detection**: Duckie detects when pages are updated

## Example Setup

### Documentation Space

```
📖 Product Docs Space
  ├── Getting Started
  │   ├── Installation Guide
  │   └── Quick Start
  ├── User Guide
  │   ├── Feature Documentation
  │   └── Best Practices
  └── API Reference
      ├── Authentication
      └── Endpoints
```

### Knowledge Base Space

```
❓ Support KB Space
  ├── Common Issues
  ├── How-To Articles
  ├── Release Notes
  └── FAQs
```

## Troubleshooting

### "Cannot access Confluence"

* Re-authenticate the connection
* Verify your Atlassian account has Confluence access
* Check that the site is accessible

### "Space not appearing"

* Ensure you have permission to view the space
* Try reconnecting with an account that has access

### "Content outdated"

* Click **Sync Now** to force refresh
* Check that the page wasn't recently moved or deleted