rank-math/list-redirections returns a paginated list of Rank Math redirections with their sources, target, status code, status and hit count.
Filter by status, including trashed — inspecting the trash here is the step before emptying it.
At a glance
| Ability | rank-math/list-redirections |
| Toolset | Rank Math — toolset/rank-math |
| Group | Rank Math › Redirections & 404s |
| Requires | Rank Math SEO, active on the site |
| Capability | manage_options |
| Safety | Read-only — changes nothing |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Abilities Manager 0.0.34 and later |
How it works
A redirection can have several sources pointing at one target, each with its own comparison mode. The list returns all of them, because a rule with five sources behaves very differently from five rules and the difference is invisible if you only see the first.
The hit count is the field that makes a cleanup possible. Rules with zero hits over a long period are either protecting a URL nobody visits any more or were never right in the first place, and either way they are candidates for removal.
Trashed rules are inactive but restorable, which makes the trash the safe place to put a rule you think is obsolete. Listing it with status=trashed before emptying is how you avoid discovering afterwards that one of them mattered.
This answers what rules exist. It cannot answer why does this URL redirect — a regex or contains rule need not contain the URL literally, so rank-math/find-redirection is the call for that.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
status | string | No | active, inactive or trashed. |
page | integer | No | 1-based page number. |
per_page | integer | No | Rows per page. |
What comes back
| Name | Type | What it is |
|---|---|---|
redirections | array | One entry per rule: ID, sources with their comparisons, destination, status code, status and hit count. |
total | integer | How many match the filter. |
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:
What redirections do we have, and which ones are never used?
It resolves to one call:
{
"ability": "rank-math/list-redirections",
"parameters": {
"status": "active",
"per_page": 100
}
}Worth knowing
- One rule can have many sources. The list shows all of them.
- Zero-hit rules are cleanup candidates.
- Inspect the trash here before emptying it.
- Text searching this list cannot explain why a URL redirects.
Related abilities
- Find Rank Math Redirection — why a specific URL redirects
- Get Rank Math Redirection Stats — the counts before the list
- Change Rank Math Redirection Status — trash in bulk
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category