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

# Confluence Data Ingestion

> Import Confluence pages and spaces as knowledge sources

Turn your Confluence wiki into AI knowledge. Import documentation, runbooks, and internal guides so your Guru can answer questions based on your team's actual knowledge base.

## Why Ingest Confluence Data?

<CardGroup cols={2}>
  <Card title="Internal Documentation" icon="book">
    Import runbooks, onboarding guides, and process docs
  </Card>

  <Card title="CQL-Powered Selection" icon="filter">
    Use Confluence Query Language to import specific spaces or pages
  </Card>

  <Card title="Attachments Included" icon="paperclip">
    Images and files attached to pages are indexed too
  </Card>

  <Card title="Auto-Sync" icon="rotate">
    Backfill jobs automatically import updated pages on a schedule
  </Card>
</CardGroup>

## What Gets Indexed

| Content Type    | What's Included                                                 |
| --------------- | --------------------------------------------------------------- |
| **Pages**       | Full page content including tables, code blocks, and formatting |
| **Comments**    | Page comments with context                                      |
| **Attachments** | Images, PDFs, and text files                                    |
| **Metadata**    | Space, labels, author, and last modified date                   |

<Note>
  **Self-hosted:** This integration is in beta for selected users.
  **Cloud:** Available to all users.
</Note>

***

## Setup

<Steps>
  <Step title="Create Atlassian API Token">
    1. Go to [Atlassian API Token settings](https://id.atlassian.com/manage-profile/security/api-tokens)
    2. Click **Create API token**
    3. Copy the token
  </Step>

  <Step title="Navigate to Confluence Integration">
    Go to **Gurubase Dashboard** → Select your Guru → **Integrations** → **Ingestions** → **Confluence**
  </Step>

  <Step title="Connect Your Confluence">
    Fill in the connection details:

    | Field          | Value                                                     |
    | -------------- | --------------------------------------------------------- |
    | **Domain**     | Your Atlassian domain (e.g., `yourcompany.atlassian.net`) |
    | **User Email** | Your Atlassian account email                              |
    | **API Token**  | The token you created in Step 1                           |

    <Frame>
      <img src="https://mintcdn.com/gurubase/VtcaSrKf-gN2CVzi/images/ingestion/confluence/confluence-fields.png?fit=max&auto=format&n=VtcaSrKf-gN2CVzi&q=85&s=8d32986320c7057e60e57c53fc8e3980" alt="Confluence Integration Fields" width="1788" height="1486" data-path="images/ingestion/confluence/confluence-fields.png" />
    </Frame>
  </Step>
</Steps>

***

## Adding Confluence Content

After connecting, you can import pages in two ways:

<Frame>
  <img src="https://mintcdn.com/gurubase/VtcaSrKf-gN2CVzi/images/ingestion/confluence/modal.png?fit=max&auto=format&n=VtcaSrKf-gN2CVzi&q=85&s=bdf377984455b88fb50a9cb9d65d8dab" alt="Add Confluence Content Modal" width="3018" height="1616" data-path="images/ingestion/confluence/modal.png" />
</Frame>

### Option 1: Add Individual Pages

Best for importing specific pages by URL.

<Frame>
  <img src="https://mintcdn.com/gurubase/VtcaSrKf-gN2CVzi/images/ingestion/confluence/individual.png?fit=max&auto=format&n=VtcaSrKf-gN2CVzi&q=85&s=765ffc9bf0250ba90558279fb739543f" alt="Add Individual Confluence Pages" width="3016" height="1616" data-path="images/ingestion/confluence/individual.png" />
</Frame>

| Setting        | Description                                 |
| -------------- | ------------------------------------------- |
| **URLs**       | Enter page URLs, one per line               |
| **Date Range** | Optionally filter by last modified date     |
| **CQL Filter** | Additional CQL criteria to refine selection |

### Option 2: Create Backfill Job

Best for bulk imports and automatic ongoing sync using CQL queries.

<Frame>
  <img src="https://mintcdn.com/gurubase/VtcaSrKf-gN2CVzi/images/ingestion/confluence/backfill.png?fit=max&auto=format&n=VtcaSrKf-gN2CVzi&q=85&s=852722eceb078d4744870c1af213f444" alt="Create Confluence Backfill Job" width="3016" height="1612" data-path="images/ingestion/confluence/backfill.png" />
</Frame>

| Setting           | Description                                           |
| ----------------- | ----------------------------------------------------- |
| **CQL Query**     | Query to select which pages to import                 |
| **Sync Interval** | How often to check for updated pages (minimum 1 hour) |
| **Sync Now**      | Manually trigger an immediate sync                    |

### Example CQL Queries

```sql theme={null}
-- All pages from a specific space
space = "DOCS" AND type = "page"

-- Recently updated documentation
space = "ENGINEERING" AND lastModified >= now("-30d")

-- Pages with specific labels
label = "runbook" OR label = "onboarding"

-- Search by title
title ~ "API" AND space = "DEVELOPER"
```

<Tip>
  Use backfill jobs to keep your Guru automatically updated whenever your team updates Confluence documentation.
</Tip>

***

## Viewing Indexed Content

Imported pages appear as individual sources in your Guru's data sources list. You can:

* View the exact content that was indexed
* Remove specific pages
* Check when content was last synced

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Jira Ingestion" icon="jira" href="/integrations/ingestion/jira">
    Import Jira issues as knowledge sources
  </Card>

  <Card title="Zendesk Ingestion" icon="headset" href="/integrations/ingestion/zendesk">
    Import Zendesk tickets and articles
  </Card>

  <Card title="Slack Bot" icon="slack" href="/integrations/bots/slack">
    Deploy Gurubase in Slack
  </Card>

  <Card title="Data Sources" icon="database" href="/guides/data-sources">
    Add more knowledge sources
  </Card>
</CardGroup>