Taxonomy: CDA support will be available for all customers

Our CDA (Content Delivery API) support for Taxonomy is currently entering the GA stage for users. We will be gradually rolling out this capability to all users within the next few days. You can now filter entries using Taxonomy Concept IDs, including filtering by descendants. This allows you to deliver a more personalized and contextually relevant user experience by leveraging structured and categorized content.

This enhancement allows you to build more advanced content discovery and filtering capabilities using the hierarchical structure of taxonomies. Users can now target entries not only by specific concepts but also by related concepts, unlocking more dynamic content curation.

What’s now available:

  • You can filter entries in the CDA by specific Taxonomy Concept IDs using the [exists], [in], [nin] and [all] operators, similar to how tags are filtered.
  • The metadata.concepts.descendants with operator [in] allows you to discover entries that belong to specific concept’s descendants.
  • Payload changes: entries now include taxonomy fields, making it easier to retrieve and filter by taxonomy-related metadata in CDA and CMA.

What Hasn’t Changed: Existing filtering methods outside taxonomy, such as tags and categories, remain unchanged.

No impact on users who do not utilize taxonomy in their content model. For more details, read our documentation.

Taxonomy: CDA support will be available for all customers | Contentful