What’s new in Gutenberg 21.7? (24 September) 🔗 **Source:** [What’s new in Gutenberg 21.7? (24 September)](https://make.wordpress.org/core/2025/09/29/whats-new-in-gutenberg-21-7-24-september/) > [!note]+ Document Notes > tags: [Gutenberg, WordPress, Block Editor] > author: Make WordPress Core > source: Make WordPress Core > reference: [https://make.wordpress.org/core/2025/09/29/whats-new-in-gutenberg-21-7-24-september/] > date created: 2025-10-06 00:00 > > # 🏷️ Title: What’s new in Gutenberg 21.7? (24 September) > <!-- deep-read:sections start --> ## 🧰 Action Inbox - [H1] Pilot Terms Query demo for taxonomy archives — context/article #articleseed - [H2] Test contentOnly for patterns in onboarding sites — context/article #xref - [H3] Draft DataViews use-cases for admin UX — context/article #articleseed - [H6] Record video on Block Commenting workflows — context/article #share - [H7] Validate Core Data fixes in plugins — context/article #xref - [H5] Showcase Write mode “Create page” flow — context/article #share - [H8] Welcome first-timers in The WPOCC channels — context/article #share - [H3] Propose FAIR.pm forms with DataForm controls — context/article #articleseed - [H10] Track bugfixes impacting contributor experience — context/article #xref - [H11] Update governance docs on release process split — context/article #addendum ## 🧭 Table of Contents - [📝 Summary](#-summary) - [📖 Main Content](#-main-content) - [🗒️ Notes](#️-notes) - [📚 References](#-references) - [🗣️ Paraphrase](#️-paraphrase) - [📰 Newsletter](#-newsletter) - [✅ Action Items](#-action-items) - [🧪 Hypotheses](#-hypotheses) - [📊 Methodology](#-methodology) - [❓ Questions](#-questions) - [🔮 Future Research](#-future-research) - [💡 Implications](#-implications) - [🧠 Learning Styles Assessment](#-learning-styles-assessment) - [📊 Accessibility Assessment](#-accessibility-assessment) - [🌍 DEIB Assessment](#-deib-assessment) - [✅ Logical Validity](#-logical-validity) - [🛡️ DARVO Analysis](#-darvo-analysis) - [🎯 Conclusion](#-conclusion) ### 🔗 References - Include links cited in or relevant to the article. ## 📝 Summary - Gutenberg 21.7 ships experiments, UX polish, and fixes. - Teams get better taxonomy listing, forms, and comments. - Core contributors and first-timers moved key pieces forward. - Experiments pose stability risks and require testing gates. - Bottom line: iterate safely and try new workflows. Sources: - Article overview: What’s new in Gutenberg 21.7? (24 September) — Make WordPress Core. https://make.wordpress.org/core/2025/09/29/whats-new-in-gutenberg-21-7-24-september/ - Release tag reference: Gutenberg v21.7 on GitHub. https://github.com/WordPress/gutenberg/releases/tag/v21.7 ## 📖 Main Content - The release adds a Terms Query block for taxonomy terms. - contentOnly arrives experimentally for unsynced patterns and template parts. - DataViews and DataForm gain new fields and validation. - Write mode improves page creation and focus behaviors. - Block Commenting supports reopening and inline comments on published posts. - Core Data fixes reduce partial data and resolution issues. - Docs split the release process into clearer pages. Context: - Experiments live behind toggle switches in Gutenberg. - DataViews aims to standardize admin data listing patterns. - Validation in DataForm reduces inconsistent form states. - Improved comments help editorial teams collaborate. Uncertainties: - Experiments may change or ship behind feature flags. - Performance impact of DataViews features needs field testing. Citations: - Terms Query, contentOnly, DataViews, Write mode, and fixes summary are in the article. https://make.wordpress.org/core/2025/09/29/whats-new-in-gutenberg-21-7-24-september/ - Experiments guidance: Gutenberg Experiments. https://developer.wordpress.org/block-editor/reference-guides/experiments/ ### 🗒️ Notes ### [H1] Terms Query block debuts for taxonomies > “Experiment: Terms Query Block” Lets sites list categories or tags flexibly. Enable under Gutenberg → Experiments. Source: https://make.wordpress.org/core/2025/09/29/whats-new-in-gutenberg-21-7-24-september/ ### [H2] Unsynced patterns get contentOnly protection > “contentOnly for Unsynced Patterns and Template Parts” Reduces accidental layout edits. Toggle in Gutenberg → Experiments. Source: https://make.wordpress.org/core/2025/09/29/whats-new-in-gutenberg-21-7-24-september/ ### [H3] DataViews adds color field and picker > “Add color field type and control to DataViews.” Improves configuration for custom dashboards and lists. Source: https://make.wordpress.org/core/2025/09/29/whats-new-in-gutenberg-21-7-24-september/ ### [H4] DataForm expands validation coverage > “DataForm select control: Support validation.” Standardizes form behaviors for reliable inputs. Source: https://make.wordpress.org/core/2025/09/29/whats-new-in-gutenberg-21-7-24-september/ ### [H5] Write mode improves page creation flow > “Add Navigation Add Page Button.” Speeds menu building with fewer context switches. Source: https://make.wordpress.org/core/2025/09/29/whats-new-in-gutenberg-21-7-24-september/ ### [H6] Block Commenting reopens resolved threads > “Add the ability to reopen resolved comments.” Supports iterative editorial reviews post-publication. Source: https://make.wordpress.org/core/2025/09/29/whats-new-in-gutenberg-21-7-24-september/ ### [H7] Core Data avoids partial returns > “Core Data: Don’t return partial data when selecting a complete item.” Prevents confusing state during data fetches. Source: https://make.wordpress.org/core/2025/09/29/whats-new-in-gutenberg-21-7-24-september/ ### [H8] First-timers merge meaningful PRs > “The following PRs were merged by first-time contributors:” Recognize and retain new contributors through spotlighting. Source: https://make.wordpress.org/core/2025/09/29/whats-new-in-gutenberg-21-7-24-september/ ### [H9] Navigation Link clarifies “Create page” > “Navigation Link: Surface page creation functionality clearly in the LinkUI.” Reduces confusion between adding and creating. Source: https://make.wordpress.org/core/2025/09/29/whats-new-in-gutenberg-21-7-24-september/ ### [H10] Components fix popover and modal issues > “Fix popover not calling onClose on unmount.” Improves component lifecycle reliability. Source: https://make.wordpress.org/core/2025/09/29/whats-new-in-gutenberg-21-7-24-september/ ### [H11] Docs split release process page > “Docs: Split “Gutenberg Release Process” page into two.” Increases clarity for release managers and reviewers. Source: https://make.wordpress.org/core/2025/09/29/whats-new-in-gutenberg-21-7-24-september/ ## 📚 References - What’s new in Gutenberg 21.7? (24 September) — Make WordPress Core: https://make.wordpress.org/core/2025/09/29/whats-new-in-gutenberg-21-7-24-september/ - Gutenberg v21.7 release notes — GitHub: https://github.com/WordPress/gutenberg/releases/tag/v21.7 - Gutenberg Experiments — Handbook: https://developer.wordpress.org/block-editor/reference-guides/experiments/ - Block Editor Handbook (overview): https://developer.wordpress.org/block-editor/ ## 🗣️ Paraphrase - Gutenberg 21.7 introduces new experiments and fixes. - Teams see better taxonomy lists, forms, and comments. ## 📰 Newsletter - Gutenberg 21.7 lands with taxonomy listings via Terms Query. - contentOnly protects unsynced patterns in tests. - DataViews and DataForm gain validation and new fields. - Editorial teams can reopen resolved block comments. - Try the experiments, then report feedback upstream. - Read more: What’s new in Gutenberg 21.7? https://make.wordpress.org/core/2025/09/29/whats-new-in-gutenberg-21-7-24-september/ ## ✅ Action Items #### DevRel - Run a Terms Query live demo with Q&A. - Publish a quickstart for contentOnly experiments. - Record a clip on reopening block comments. #### OSPO - Document feature-flag policies for experiments. - Track SBOM changes for UI packages touched. - Align validation standards across internal forms. #### Community - Host a contributor chat on DataViews use. - Pair first-timers with maintainers for follow-ups. - Share a testing brief for Write mode. #### WordPress - Core: monitor Core Data regressions. - Core Performance: profile DataViews rendering. - Core AI: none this cycle. - Core Program Team: note release process doc split. - Training: add lessons on Terms Query. - Documentation: update LinkUI “Create page.” - Accessibility: test comment indicators and dialogs. - Meta: ensure .org docs link to experiments page. - Themes: test contentOnly with template parts. - Plugins: verify data selectors in custom stores. #### The WPOCC - Celebrate first-time contributors publicly. - Offer microgrants for DataViews docs. - Fund testing sprints for experiments. ### FAIR - Evaluate DataForm validation for policy templates. - Propose governance scorecards using DataViews. - Publish provenance notes for UI component changes. ## 🧪 Hypotheses - Terms Query reduces custom taxonomy code by 30%. - contentOnly cuts accidental layout edits by 50%. - Validation changes lower form error rates by 25%. - Reopenable comments improve editorial cycle time by 15%. ### 📊 Methodology - Run A/B tests on editor branches. - Measure undo events near locked blocks. - Track form submission error rates. - Time editorial review loops with comments. ### ❓ Questions - Should Terms Query support nested hierarchies by default? - How will contentOnly interact with synced patterns? - Do comment indicators meet WCAG contrast? ### 🔮 Future Research - Evaluate DataViews performance on large datasets. - Study Write mode adoption and retention. - Explore taxonomy templates using Terms Template. ### 💡 Implications - Fewer custom plugins for taxonomy listings. - Safer editing for complex templates. - Stronger collaboration for content teams. ### 🧠 Learning Styles Assessment - Reading level estimate: Flesch-Kincaid Grade ≈ 10. #### 👀 Visual learners - Present: UI labels and controls. - Improve: add before/after screenshots. #### 🔊 Aural learners - Present: none noted. - Improve: provide a short audio brief. #### 🗣️ Verbal learners - Present: concise bullet updates. - Improve: add glossaries for new terms. #### 🧩 Kinesthetic learners - Present: experiments to toggle. - Improve: guided labs with tasks. #### 🧠 Logical learners - Present: categorized change lists. - Improve: flow diagrams for data paths. #### 🧑‍🤝‍🧑 Social learners - Present: comment features for teams. - Improve: discussion prompts and clinics. #### 🧘‍♀️ Solitary learners - Present: documentation links. - Improve: self-check quizzes. #### 🌿 Naturalistic learners - Present: not applicable. - Improve: lifecycle notes for features. ### 📊 Accessibility Assessment #### Screen reader semantics - Present: likely proper headings. - Improve: ensure alt text and labels. #### Keyboard navigation - Present: visible focus in editor. - Improve: test new dialogs thoroughly. #### Contrast and readability - Present: standard editor themes. - Improve: verify comment indicators contrast. #### Text resizing and reflow - Present: responsive editor canvas. - Improve: confirm 200% reflow for dialogs. #### Media and captions - Present: none. - Improve: add captions to any demos. #### Forms and interactions - Present: improved validation. - Improve: inline error summaries. #### Standards reference - Map gaps to WCAG 2.2 AA. ### 🌍 DEIB Assessment #### Cultural breadth - Present: global contributor base. - Improve: multi-locale examples. #### Inclusive language - Present: clear button labels. - Improve: more plain-language tooltips. #### Neurodiversity support - Present: consistent structure. - Improve: reduce cognitive load in dialogs. #### Representation - Present: credit first-timers. - Improve: spotlight diverse roles. #### Psychological safety - Present: respectful acknowledgements. - Improve: clear escalation paths. ### ✅ Logical Validity #### Strong reasoning - Categorized changes improve scannability and trust. - Experiments behind toggles signal prudent risk management. #### Fallacies - None apparent in factual change logs. - Avoid overgeneralizing early experiment results. #### Tone of voice - Factual, concise, and release-focused. ### 🛡️ DARVO Analysis - No denial patterns observed. - No attacks on contributors noted. - No role reversal rhetoric present. ## 🎯 Conclusion - Gutenberg 21.7 strengthens workflows, safety, and collaboration. - Test experiments, measure impacts, and report findings upstream. Tag Coverage — #articleseed: 3 • #xref: 3 • #share: 3 • #addendum: 1 • #bmf: 0 • #aphorisms: 0 ## 🧱 Refactor Appendix (append after 🎯 Conclusion) ### 📚 Literature Split Pad - Purpose: Stage Konik CEE units that become per-source Literature notes. - Split level: **H3**. - Include verbatim quotes under 25 words and a [view highlight] link. ### [H1] Terms Query enables taxonomy listings > [!quote] [What’s new in Gutenberg 21.7?](https://make.wordpress.org/core/2025/09/29/whats-new-in-gutenberg-21-7-24-september/) by [[Make WordPress Core]] via [[Make WordPress Core]]. Published 2025-09-29. Accessed 2025-10-06. > “Experiment: Terms Query Block” Use for categories/tags archives and taxonomy showcases. [view highlight](https://make.wordpress.org/core/2025/09/29/whats-new-in-gutenberg-21-7-24-september/#H1) #xref #articleseed ID:rw_[MISSING] ### [H2] contentOnly protects unsynced templates > [!quote] [What’s new in Gutenberg 21.7?](https://make.wordpress.org/core/2025/09/29/whats-new-in-gutenberg-21-7-24-september/) > “contentOnly for Unsynced Patterns and Template Parts” Reduce accidental layout edits in complex sites. [view highlight](https://make.wordpress.org/core/2025/09/29/whats-new-in-gutenberg-21-7-24-september/#H2) #xref ID:rw_[MISSING] --- ### 🔖 Atomic Split Pad (Zettel Candidates) - Purpose: Promote reusable claims into Atomic notes. - Split level: **H4**. - Each item: one idea, present tense, specific, testable. #### [Z1] Terms Query simplifies taxonomy displays - For archives and directory-like pages. - Links: [[Gutenberg]] [[Taxonomy]] #### [Z2] contentOnly reduces layout errors - When teams edit content in shared patterns. - Links: [[Editor-Safety]] [[Governance]] --- ### ✏️ Fleeting Queue (Extract by Selection) - Purpose: Capture quick actions or sparks for Fleeting notes. - Extraction: **Select one line** → “Refactor: Extract selection to new note (content only).” - [F1] Draft Terms Query tutorial — context/https://make.wordpress.org/core/2025/09/29/whats-new-in-gutenberg-21-7-24-september/ #fleeting #inbox - [F2] Measure contentOnly impact on support tickets — context/https://make.wordpress.org/core/2025/09/29/whats-new-in-gutenberg-21-7-24-september/ #fleeting #inbox - [F3] Record block comments quick tip — context/https://make.wordpress.org/core/2025/09/29/whats-new-in-gutenberg-21-7-24-september/ #fleeting #inbox --- <!-- deep-read:sections end -->