Jama Connect Interchange™ Synchronization Fails with "The Field Value Is Not Valid Atlassian Document Format (ADF) Content" Error

Published Date: November 10, 2026
Validated: Yes
Audience: Everyone
Products and Versions Covered:

Jama Connect Interchange™ version(s) All
- JCI Module:
  - Jira Cloud
  - Jira Data Center

Summary

When synchronizing requirements from Jama Connect® to Jira Cloud using Jama Connect Interchange™, the synchronization may fail with an "Unable to create entity: null" or "INVALID_INPUT" error.

The error may occur when a requirement description contains unsupported HTML formatting, empty nested bullet lists, or non-breaking spaces that Jira Cloud cannot process as valid Atlassian Document Format (ADF) content.

The following error may appear in the logs:

 {"description":"The field value is not valid Atlassian Document Format (ADF) content."}
managers.exceptions.VendorManagerException: {"description":"The field value is not valid Atlassian Document Format (ADF) content."}

Resolution

Identify the affected requirement

Review the Jama Connect Interchange™ synchronization logs to identify the error and affected requirement.
Locate the requirement in Jama Connect® and review its description for unsupported formatting.
Check for empty nested bullet lists, unnecessary HTML tags, and non-breaking spaces that may cause Jira Cloud to reject the description.

Clean up the description formatting

Edit the affected requirement description.
Remove empty nested bullet lists and unnecessary HTML formatting.
Remove or replace non-breaking spaces where applicable.
Preserve the original text and valid bullet-list structure.
Save the updated requirement.

Verify synchronization

Run the synchronization again in Jama Connect Interchange.
Confirm that the requirement synchronizes successfully to Jira Cloud.
If the error persists, review the description for additional unsupported formatting and repeat the cleanup process.

Note: Removing empty nested bullet lists may resolve the Atlassian Document Format validation error. If the issue continues after cleaning the description, additional formatting may require investigation.

Additional Resources

Feedback:
We welcome your input! Please sign in to leave any comments, suggestions, or ideas for improvement below.

Related to