rank-math/delete-post-schemas removes every Rank Math schema attached to a post, including the type index. It refuses without confirm: true.
Including the type index is the part that distinguishes it from deleting the meta rows.
Before you run it
This removes every schema on the post, not a selected one, and the markup cannot be recovered. The post will emit no structured data at all until new schema is added — which for an article or a product means losing whatever rich result it was earning. Inspect what is there first with Rank Math’s own rank-math/get-post-schema ability.
At a glance
| Ability | rank-math/delete-post-schemas |
| Toolset | Rank Math — toolset/rank-math |
| Group | Rank Math › Schema |
| Requires | Rank Math SEO, active on the site |
| Capability | manage_options |
| Safety | Destructive — deletes stored values, and refuses to run without confirm: true |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Abilities Manager 0.0.34 and later |
How it works
Rank Math keeps the schemas as meta rows and a separate index of which types the post carries. Deleting the rows without the index leaves the index claiming schema types that no longer exist.
That orphaned state is not harmless. Rank Math reads the index when deciding what to assemble, and a reference to a missing schema produces incomplete output rather than no output — which is the hardest kind of structured data problem to diagnose, because everything looks present.
So this removes both, and verifies nothing is left pointing at anything.
Idempotent: running it on a post with no schema is a no-op rather than an error.
After this the post emits no structured data. Whether that matters depends on what it was emitting — clearing a stray unused schema is tidy; clearing an Article schema from a post that was earning a rich result is a change to how it appears in search.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
object_id | integer | Yes | The post, term or user ID. |
object_type | string | No — defaults to post | post, term or user. |
confirm | boolean | Yes — must be true | The irreversibility gate. Without it the call is refused before anything is touched. |
What comes back
| Name | Type | What it is |
|---|---|---|
object_id | integer | The object cleared. |
deleted | integer | How many schemas were removed. |
success | boolean | Whether the call completed. |
message | string | A one-line summary of what happened, suitable for showing a human. |
error_code | string | Present only on failure — a stable machine-readable reason, such as a missing field, a wrong field type or an unmet confirmation. |
Example
Ask your assistant:
Remove all the schema from post 412 so I can start again.
It resolves to one call:
{
"ability": "rank-math/delete-post-schemas",
"parameters": {
"object_id": 412,
"confirm": true
}
}Worth knowing
- Removes every schema, not a selected one.
- The type index goes too, which is what avoids orphaned references.
- Not recoverable. Read what is there first.
- Idempotent — clearing an empty post is a no-op.
Related abilities
- Update Rank Math Post Schemas — add new schema afterwards
- Get Rank Math Rendered Head — confirm nothing is emitted
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category