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

# Confluence troubleshooting

> Start at the Confluence source row in Data Sources. Recent sync errors show there; for "sync completed but pages are missing", open AI Instructions and filter by Confluence.

Start at the **Confluence** source row in [**Data Sources**](https://platform.open.cx/data-sources). Recent sync errors show there; for "sync completed but pages are missing", open AI Instructions and filter by **Confluence**.

## Common scenarios

| Symptom                                                                                          | Likely cause                                                                                                                      | Fix                                                                                                                                                                                                                                                                  |
| ------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Sync fails with 401 / unauthorized**                                                           | API token is invalid, revoked, or belongs to an account that doesn't have Confluence access                                       | Re-generate the token at [Atlassian API tokens](https://id.atlassian.com/manage-profile/security/api-tokens). Confirm the email matches the token owner. Update both fields in the source.                                                                           |
| **"Space not accessible" errors in the logs**                                                    | The token's account doesn't have read permission for some spaces                                                                  | Grant read access to the Confluence user in Atlassian space settings, or accept that restricted spaces are skipped. The rest of the sync proceeds.                                                                                                                   |
| **Pages from a personal space show as internal and the AI never cites them in customer replies** | Working as designed — personal spaces (keys starting with `~`) are marked internal                                                | Override visibility per-page in [AI Instructions](https://platform.open.cx/ai-instructions), or move the content to a non-personal space in Confluence.                                                                                                              |
| **Sync is extremely slow / times out on a huge instance**                                        | `full_refresh_overwrite` pulls every page every run                                                                               | Reduce the Confluence connection's sync cadence in the Airbyte schedule. If your instance has thousands of pages, consider breaking content out into a dedicated space and using the [Website crawler](/knowledge/sources/website/overview) against a public mirror. |
| **Source URLs in the AI's citations are missing or wrong**                                       | The `webui` path is only assembled when the backend can look up your Confluence domain; if the domain didn't save, URLs are empty | Re-enter the **Domain** field exactly as `yourcompany.atlassian.net` (no scheme, no trailing slash). Trigger a re-sync.                                                                                                                                              |
| **Confluence Server / Data Center**                                                              | Not supported today                                                                                                               | Cloud only. Migrate or use the [Website crawler](/knowledge/sources/website/overview) against a published export.                                                                                                                                                    |
| **None of the above**                                                                            | —                                                                                                                                 | Contact support with the connection ID and sample page URL.                                                                                                                                                                                                          |

***

## Related Documentation

<CardGroup cols={2}>
  <Card title="Connect Confluence" icon="plug" href="/knowledge/sources/confluence/connect">
    Re-check credentials and limits.
  </Card>

  <Card title="Confluence overview" icon="confluence" href="/knowledge/sources/confluence/overview">
    What this source does.
  </Card>

  <Card title="Website crawler" icon="globe" href="/knowledge/sources/website/overview">
    Fallback for scoped subsets.
  </Card>

  <Card title="Connect a knowledge source" icon="brain" href="/knowledge/sources/overview">
    All sources.
  </Card>
</CardGroup>
