12.0.0
Yoast SEO for TYPO3 — Release Notes v12.0.0
We're excited to announce the release of Yoast SEO for TYPO3 v12.0.0! This is a major release that brings TYPO3 14 support, powerful new analysis features, social media previews, and significant under-the-hood improvements.
⚠️ This release contains breaking changes. Please review the Breaking Changes section carefully before upgrading.
🚀 Major Features
TYPO3 14 Support
Yoast SEO for TYPO3 now fully supports TYPO3 14, ensuring compatibility with the latest version of the TYPO3 CMS.
Social Previews for Open Graph and X/Twitter
Preview how your content will appear when shared on Facebook (Open Graph) and X (formerly Twitter) directly from the TYPO3 backend. Optimize your social sharing without leaving your editor.
Inclusive Language Analysis
A new inclusive language analysis is now available alongside the existing SEO and Readability analyses. This feature helps editors write more inclusive and welcoming content.
This analysis is disabled by default and can be enabled through a feature toggle, see the documentation.
Frontend Request Functionality Extracted
The functionality for making requests to the frontend from the backend has been moved to a separate, reusable package: maxserv/frontend-request. This separation improves maintainability and allows other extensions to benefit from the same functionality.
Backend JavaScript Rewritten in TypeScript
The entire backend JavaScript codebase has been rewritten in TypeScript. The Yoast components are now consumed exclusively as web components, keeping the extension aligned with TYPO3 core practices and making it easier for external contributors to work on the codebase.
✨ Minor Features
Per-Page Analysis Toggle
The previous "Hide snippet preview" option has been split into two independent toggles:
- Hide snippet preview — controls visibility of the snippet preview only.
- Disable analysis — disables the SEO, readability, and inclusive language analyses for a page.
You can now hide the snippet preview without disabling the analysis (and vice versa). Disabling the analysis on a page also prevents that page from appearing in internal linking suggestions.
An upgrade wizard is provided to migrate the existing flag to the new structure, preserving current behavior for all pages.
Frontend Request Cache Toggle
A new feature toggle has been added to fully disable the cache on the frontend request, helping to prevent edge cases in specific environments and setups.
See the documentation for the correct feature toggle.
🔧 Improvements
- Linking suggestions performance — improved database schema and optimized queries for faster, more efficient internal linking suggestions.
- Translation handling — improved score saving for translated pages.
- Snippet preview — the website title is now displayed in the snippet preview.
- Slug analysis — the page slug is now taken into account during analysis.
- Language support — added support for the
gu(Gujarati) andlo(Lao) locales. - Test coverage — updated and expanded both functional and unit tests.
- Codebase cleanup — extensive refactoring including class splitting, general improvements, and removal of legacy classes.
⚠️ Breaking Changes
Please review these carefully before upgrading.
Dropped: TYPO3 11 Support
TYPO3 11 is no longer supported. Please ensure your installation is on TYPO3 12, 13, or 14 before upgrading.
Dropped: PHP 8.0 and 8.1 Support
The minimum required PHP version is now PHP 8.2.
Removed: ModifyPreviewEvent
The ModifyPreviewEvent has been removed. It has been replaced by ModifyUrlEvent from the new maxserv/frontend-request package.
If you have custom code listening to ModifyPreviewEvent, you will need to update it to use ModifyUrlEvent instead.
📦 Upgrading
Before upgrading, make sure your environment meets the new requirements:
- TYPO3 12, 13, or 14
- PHP 8.2 or higher
After upgrading, run the TYPO3 upgrade wizards to migrate the legacy "Hide snippet preview" flag to the new split flags.