Confluence Unstructured Connector Limitations and Troubleshooting

Supported Content Types

The Confluence Unstructured connector ingests the following content types:

Pages (including nested/child pages)
Blog posts
Comments (on pages and blog posts)
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, 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

Verify the Cloud ID is correct by navigating to https://<your-domain>.atlassian.net/_edge/tenant_info.
Verify the Named Credential authentication was completed successfully by re-authenticating with the Confluence 3LO provider.
Verify the Admin API Token is valid and has not expired.
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:

Verify the Space ID is correct. The Space ID is case-sensitive (for example, ENG not eng). Check the URL: https://<domain>.atlassian.net/wiki/spaces/<SPACE_ID>/overview.
Verify content exists in the space. Empty spaces or spaces containing only restricted content will result in zero records.
Verify the authenticated user has read access to all content in the space, including restricted pages and blog posts.
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.
Check the UDLO Sync Status Detail field for individual record failure reasons.
Verify the Data Stream completed successfully. Navigate to the Data Stream and check for connector exceptions or partial failures.
For attachments: Verify the attached files use supported MIME types and are within size limits.

Partial Data Ingested

Large spaces may require additional sync cycles due to API rate limits.
Verify the authenticated user has permission to access all content in the space, including restricted pages.
Check the UDLO for skipped records. Some content may have been excluded due to file size, format, or content age rules.
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