rank-math/find-redirection finds which redirections match a given URL or path by evaluating Rank Math’s own source rules: exact, contains, start, end and regex.
This is how you explain why a URL redirects. A text search over the redirection list cannot.
At a glance
| Ability | rank-math/find-redirection |
| 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
Four of the five comparison modes match URLs that do not contain the rule’s text in any searchable way. A contains rule for /old catches /blog/old-pricing; a regex rule may contain no literal path at all.
So grepping the list for the URL you are investigating finds nothing, and the conclusion “there is no rule for this” is wrong.
This evaluates the rules the way Rank Math does at request time, and returns every rule that matches — which can be more than one. Order matters when several match, and seeing all of them is how you find the rule that is shadowing the one you meant to use.
It is also the check before creating a rule. Two rules matching the same URL is a common and confusing state, and it is easier to avoid than to unpick.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
url | string | Yes | The URL or path to test. |
What comes back
| Name | Type | What it is |
|---|---|---|
matches | array | Every rule that matches, with its source and comparison. |
count | integer | How many matched. |
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:
Why does /old-pricing redirect to the homepage?
It resolves to one call:
{
"ability": "rank-math/find-redirection",
"parameters": {
"url": "/old-pricing"
}
}Worth knowing
- Evaluates the rules rather than searching their text.
- More than one rule can match. The extras are usually the problem.
- Run it before creating a rule, not only when diagnosing one.
- Read-only.
Related abilities
- Create Rank Math Redirection — check here first
- List Rank Math Redirections — the full inventory
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category