Publish a Taxonomy
Publishing a taxonomy deploys the complete taxonomy structure, including all its terms. This makes the taxonomy available for use across selected environments and locales.
For example, an e-commerce team updates the Color taxonomy by reorganizing its terms. First, they publish the revised taxonomy to the development environment to validate the changes. Once verified, they publish it to production, making the updated structure live for customers.
Note
- Publishing always includes the entire taxonomy and all its terms; publishing individual terms is not supported.
- Publishing is required to expose taxonomy changes.
- Published taxonomies do not support version history or rollback.
- Publishing overwrites the previously published taxonomy tree for the selected environment and locale.
To publish a taxonomy, log in to your Contentstack account, and perform the following steps:
- Go to your stack where you want to publish a taxonomy, navigate to Settings, and select Taxonomy.
- Open the taxonomy you want to publish and click Publish.
- In the Publish Taxonomy modal, select the Branch, Environments, and Locales.
Note Taxonomy is a global module. However, when publishing, selecting a branch determines the fallback hierarchy of the selected locales in that branch.
- Choose Now to publish immediately or Later to schedule the publication.
- Click Send to confirm the publishing.
Publishing a taxonomy ensures your updated term structure is available across selected environments, locales, and branches. By following the steps outlined above, teams can confidently manage and deploy taxonomy changes that reflect evolving business needs or content strategies.
Additional Resource
- If an entry that references a taxonomy is published using Send with References, the referenced taxonomy, including all its terms, is included in the publish job. This ensures that the taxonomy structure used by the entry is available in the selected environments and locales.
- You can also add taxonomies to a release and deploy them as part of a release workflow. This allows teams to manage taxonomy changes alongside related content updates and schedule deployments across environments and locales. For more information, refer to the Add a Taxonomy to a Release documentation.
API Reference
To publish taxonomies via the API, refer to the Publish a Taxonomy API request.