--- schema_version: "1" id: c487a4f53d01cc43fb64995a847123298d3e3f35613ae230a022b1bbd8aaa4bb title: Confluence Unstructured Connector Limitations and Troubleshooting collection: developer version: current locale: en-us portal_url: https://docs.salesforce.com/developer/current/en-us/data-cloud/data-cloud-int/guides/confluence/c360-a-confluence-unstructured-connector-limitations.md canonical_url: https://developer.salesforce.com/docs/data/data-cloud-int/guide/c360-a-confluence-unstructured-connector-limitations.html source_site: developer.salesforce.com content_type: documentation content_hash: 330af41206843ff2b7e99f39482b92564fcfef02c3236d60c5a922931f4db5b4 products: - Data 360 Integration Guide - Data 360 Developer Documentation --- # Confluence Unstructured Connector Limitations and Troubleshooting ## Supported Content Types The Confluence Unstructured connector ingests the following content types: 1. Pages (including nested/child pages) 2. Blog posts 3. Comments (on pages and blog posts) 4. Attachments (files attached to Confluence content) ## Known Limitations **Confluence Cloud Only** This connector supports Atlassian Confluence Cloud (SaaS) only. Confluence Data Center and Confluence Server are not supported. **Single Space per Data Lake Object** Each UDLO ingests content from a single Confluence space. To ingest content from multiple spaces, create separate UDLOs for each space. ## Supported Attachment File Formats The connector processes the following attachment file types from Confluence pages and blog posts: | Category | Supported Formats | | :------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Documents** | application/pdf, application/msword, application/vnd.openxmlformats-officedocument.wordprocessingml.document (.docx), application/vnd.openxmlformats-officedocument.presentationml.presentation (.pptx), application/rtf, text/plain, text/csv, application/json | | **Images** | image/jpeg, image/png, image/gif, image/bmp, image/tiff, image/webp, image/svg+xml | | **Web & Text** | text/html, text/markdown | Attachments with unsupported MIME types are skipped during ingestion. ## File Size Limitations Attachments are subject to the following size limits. Files exceeding these limits are skipped. | File Type | Size Limit | | :-------------------------- | :--------- | | PDF & Documents | 100 MB | | Images | 20 MB | | All other supported formats | 4 MB | ## Last Modified Time Outdated content is skipped to ensure data relevance. **Rule:** Content older than two years relative to the current sync time will be skipped. ## Incremental Refresh Behavior After the initial full ingestion, subsequent data stream refreshes use incremental sync. - Only content created or modified since the last successful sync is processed. - Deleted content in Confluence is automatically removed from the UDLO during incremental refresh. ## Handling of Skipped Content (UDLO Reporting) When content fails any constraint check (format, size, or content age), it is skipped. The outcome is recorded in the UDLO. | Field | Value | Description | | :--------------------- | :--------------------------- | :------------------------------------------- | | **Sync Status** | SUCCESS, FAILURE, or SKIPPED | Indicates the content ingestion status. | | **Sync Status Detail** | _Detailed message_ | Provides the reason the content was skipped. | ### Ingestion Size Limits and Timeout Confluence Unstructured supports ingestion of spaces up to 500 GB per ingestion job. Data stream refreshes that exceed **24 hours** will time out. Plan ingestion jobs accordingly, especially for large spaces. If you encounter timeout failures, consider splitting content across multiple UDLOs by space to reduce per-job ingestion volume. ## Troubleshooting ### Connection Test Fails 1. Verify the Cloud ID is correct by navigating to `https://.atlassian.net/_edge/tenant_info`. 2. Verify the Named Credential authentication was completed successfully by re-authenticating with the Confluence 3LO provider. 3. Verify the Admin API Token is valid and has not expired. 4. Verify the Org ID matches the organization associated with your Confluence instance. ### No Data Ingested / Records Not Appearing in DLO If after a successful sync no records appear in the Data Lake Object: 1. **Verify the Space ID is correct.** The Space ID is case-sensitive (for example, `ENG` not `eng`). Check the URL: `https://.atlassian.net/wiki/spaces//overview`. 2. **Verify content exists in the space.** Empty spaces or spaces containing only restricted content will result in zero records. 3. **Verify the authenticated user has read access** to all content in the space, including restricted pages and blog posts. 4. **Check content age.** If all content in the space was last modified more than two years ago, all items are skipped due to the content age rule. 5. **Check the UDLO Sync Status Detail field** for individual record failure reasons. 6. **Verify the Data Stream completed successfully.** Navigate to the Data Stream and check for connector exceptions or partial failures. 7. **For attachments:** Verify the attached files use supported MIME types and are within size limits. ### Partial Data Ingested 1. Large spaces may require additional sync cycles due to API rate limits. 2. Verify the authenticated user has permission to access all content in the space, including restricted pages. 3. Check the UDLO for skipped records. Some content may have been excluded due to file size, format, or content age rules. 4. If pages were recently updated but not appearing, wait for the next incremental sync cycle to complete. **See Also** - [_Salesforce Help_: Data 360 Limits and Guidelines](https://help.salesforce.com/s/articleView?language=en_US&id=data.c360_a_limits_and_guidelines.htm&type=5)