Repository navigation
Yoast SEO 28.8 — docs(yoast-seo-abilities): Document new feature-toggle and site-representation abilities - #428
Open
claude[bot] wants to merge 5 commits into
Open
claude[bot] wants to merge 5 commits into
claude[bot] wants to merge 5 commits into
Conversation
…sentation abilities Adds documentation for the 7 new Yoast SEO abilities introduced in 28.8-RC1: - 6 feature-toggle abilities (set-llms-txt-status, set-open-graph-status, set-schema-aggregation-endpoint-status, set-schema-framework-status, set-x-card-status, set-xml-sitemap-status) - 1 site-representation ability (update-site-representation) Updates overview.md to list all new abilities and their use-case examples. Wires feature-toggles.md and site-representation.md into sidebars.js. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This was referenced Oct 14, 2026
Deploying yoast-developer with
|
| Latest commit: |
d994c29
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://eb5fe3e9.yoast-developer.pages.dev |
| Branch Preview URL: | https://rc-sync-wordpress-seo-28-8-r.yoast-developer.pages.dev |
There was a problem hiding this comment.
🔵 Needs a closer look
API contracts and Premium/Local SEO behavior require human verification against implementation sources unavailable in this checkout.
No open issues 🎉
What changed in this PR
Documents seven new Yoast SEO 28.8 abilities and integrates them into the developer documentation.
Changes:
- Documents six feature toggles, including permissions, availability, and examples.
- Documents site representation updates and Premium/Local SEO behavior.
- Updates the abilities overview and sidebar navigation.
| File | Description |
|---|---|
sidebars.js |
Adds navigation links for both new pages. |
docs/features/yoast-seo-abilities/site-representation.md |
Documents fields, responses, and usage examples. |
docs/features/yoast-seo-abilities/overview.md |
Lists and links the seven new abilities. |
docs/features/yoast-seo-abilities/feature-toggles.md |
Documents toggle contracts and availability restrictions. |
Review effort: Balanced
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
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.
RC docs sync — 28.8-RC1
Product: wordpress-seo
Area: yoast-seo-abilities
Source evidence:
src/abilities/user-interface/abilities/set-llms-txt-status-ability.php: newyoast-seo/set-llms-txt-statusability — toggle llms.txt feature, not available on multisite, returnswarningwhen file generation failssrc/abilities/user-interface/abilities/set-open-graph-status-ability.php: newyoast-seo/set-open-graph-statusability — toggle Open Graph data outputsrc/abilities/user-interface/abilities/set-schema-aggregation-status-ability.php: newyoast-seo/set-schema-aggregation-endpoint-statusability — toggle Schema Aggregation endpointsrc/abilities/user-interface/abilities/set-schema-framework-status-ability.php: newyoast-seo/set-schema-framework-statusability — toggle Schema Framework (JSON-LD output)src/abilities/user-interface/abilities/set-x-card-status-ability.php: newyoast-seo/set-x-card-statusability — toggle X card data outputsrc/abilities/user-interface/abilities/set-xml-sitemap-status-ability.php: newyoast-seo/set-xml-sitemap-statusability — toggle XML sitemap, not available when forbidden by network adminsrc/abilities/user-interface/abilities/update-site-representation-ability.php: newyoast-seo/update-site-representationability — update company/person toggle, name, logo, social profilessrc/abilities/infrastructure/site-representation-field-map.php: field schema (9 fields:company_or_person,company_name,company_alternate_name,company_logo_id,company_or_person_user_id,person_logo_id,facebook_site,twitter_site,other_social_urls)Changes in this PR
docs/features/yoast-seo-abilities/overview.md— updated ability list and use-case examples to include the 7 new abilitiesdocs/features/yoast-seo-abilities/feature-toggles.md— new page documenting all 6 feature-toggle abilities (input/output schema, availability conditions, per-ability usage examples)docs/features/yoast-seo-abilities/site-representation.md— new page documenting the update-site-representation ability (input fields table, output, usage examples)sidebars.js— addsfeature-togglesandsite-representationto the Yoast SEO Abilities navigation sectionVerification
yarn buildpasses locally in this workflow.yarn lintclean for files touched by this PR.Reviewer notes
wpseo_site_representation_ability_fieldsfilter (which allows add-ons to extend the field list) is marked@internalin the source and is not documented here.set-xml-sitemap-statusavailability condition for multisite (network admin can forbid XML sitemaps) is documented in the "Availability" section.company_or_person_user_iddescription about "only users with published posts" is verbatim from the source PHPDoc.company_or_personis documented as a caution note, sourced from the source'sget_company_or_person_description()method.Sibling PRs from this RC
Authored by the RC docs-sync agent. Not auto-merged — requires human review. Run: https://github.com/Yoast/developer/actions/runs/38522256066