Expand taxonomy/tags in the GraphQL API response for Headless Channels

2026/01/07 12:10 PM

In the GraphQL API response of a headless channel, I am looking to be able to see the hierarchy of a tag within the taxonomy module. Has anyone seen how this can be achieved?

For example, in the Taxonomies module I have:

In the API response, it might look something like this:

You can only see the name/codename of the tag, but not the hierarchy of it (e.g. from the taxonomy module, it would be nice to see it's under "Guests").

I have logged this as a request to the roadmap, to see if it can be added as a feature, maybe adding a path like KX13 used to do with the codenames? e.g. Guests/2Guests for this scenario.

Tags:
Taxonomies Headless channels GraphQL

Answers

2026/01/08 1:55 PM

I agree Liam, a (KX13 style) path property would be a nice addition.

Alternatively, a new children property, containing a list of child tags would be another way to go.

2026/01/08 2:46 PM

I don't think headless channels are at all extensible today (v31.0.0).

If you need additional taxonomy data, you can create a custom API endpoint that responds with a hierarchy path and send it the tag code name from the headless channel response or expose the taxonomy tree over an endpoint to get that hierarchy information.

For now, because headless channels are really designed for marketers to have control over what content is exposed, you might need additional endpoints for related data.

To response this discussion, you have to login first.