Document taxonomy structures - #1991
Draft
jasonvarga wants to merge 6 commits into
Draft
jasonvarga wants to merge 6 commits into
jasonvarga wants to merge 6 commits into
Conversation
Covers the Orderable toggle, max depth, nested term URLs, the tree file, the multi-site model, the hierarchy variables, descendant entry queries, and what happens when you turn the structure back off. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Taxonomy trees are a third kind of structure, and the only one that isn't per-site. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
It happens without a confirmation, and every nested entry's URL moves. Documented on neither collections nor taxonomies until now. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Term filters on a nestable taxonomy match the term's whole subtree by default. Adds the opt-out to the collection tag and the GraphQL entries query, and notes that entries_count counts descendants with no opt-out. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Adds the new tree endpoint, including that its site param localizes payloads rather than selecting a tree, and the term entries endpoint, which was undocumented. Both get with_descendants. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
jasonvarga
marked this pull request as draft
September 17, 2026 19:10
jasonvarga
added a commit
to statamic/cms
that referenced
this pull request
Sep 18, 2026
The code and the docs disagreed. statamic/docs#1991 already uses "nestable" throughout and never says "hierarchical", so the code was the outlier. This renames Taxonomy::hierarchical() to nestable() and its derivatives, along with the CP tab handle and one English string. Only the maxDepth !== 1 predicate moves. hasStructure() and orderable() are verbatim copies of Collection's and are untouched, so "structured" keeps its meaning. Config, GraphQL, REST, Antlers and JS have zero occurrences, so there is no data migration and no public surface beyond the eight PHP symbols, all of which are new in this PR. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Follows statamic/cms@24d648413f, which renamed the CP tab to "Ordering & Nesting" and Taxonomy::hierarchical() to nestable(). Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
jasonvarga
changed the title
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Documentation for statamic/cms#15192