diff --git a/docs/polygon-methods.mdx b/docs/polygon-methods.mdx
index 0abe4ee5..9d6ccb67 100644
--- a/docs/polygon-methods.mdx
+++ b/docs/polygon-methods.mdx
@@ -7,6 +7,17 @@ Our pricing is simple: 1 RU per full request, 2 RUs per archive. For which EVM m
See also [interactive Polygon API call examples](/reference/polygon-getting-started).
+Polygon runs on the Bor client, which does not implement the Erigon-only Parity `trace_*` or `erigon_*` namespaces. Migrate the `trace_*` methods to their `debug_*` equivalents:
+
+| Parity `trace_*` method | Replacement on Bor |
+| --- | --- |
+| `trace_transaction` | [`debug_traceTransaction`](/reference/polygon-tracetransaction) with `callTracer` |
+| `trace_block` | [`debug_traceBlockByNumber`](/reference/polygon-traceblockbynumber) with `callTracer` |
+| `trace_call` | [`debug_traceCall`](/reference/polygon-tracecall) with `callTracer` |
+| `trace_filter`, `trace_replayBlockTransactions`, `trace_replayTransaction` | [`debug_traceBlockByNumber`](/reference/polygon-traceblockbynumber) per block, or [`eth_getLogs`](/docs/understanding-eth-getlogs-limitations) for event ranges |
+
+The `debug_trace*` methods return equivalent execution traces on Bor. The `erigon_*` convenience methods have no Bor equivalent — use the standard `eth_*` methods instead.
+
| Method | Availability | Comment |
| ---------------------------------------- | ------------ | ------- |
| eth\_accounts | | |
@@ -55,14 +66,14 @@ See also [interactive Polygon API call examples](/reference/polygon-getting-star
| txpool\_status | | |
| web3\_clientVersion | | |
| web3\_sha3 | | |
-| erigon\_blockNumber | | |
-| erigon\_forks | | |
-| erigon\_getBlockByTimestamp | | |
-| erigon\_getBlockReceiptsByBlockHash | | |
-| erigon\_getHeaderByHash | | |
-| erigon\_getHeaderByNumber | | |
-| erigon\_getLatestLogs | | |
-| erigon\_getLogsByHash | | |
+| erigon\_blockNumber | | Use `eth_*` |
+| erigon\_forks | | Use `eth_*` |
+| erigon\_getBlockByTimestamp | | Use `eth_*` |
+| erigon\_getBlockReceiptsByBlockHash | | Use `eth_*` |
+| erigon\_getHeaderByHash | | Use `eth_*` |
+| erigon\_getHeaderByNumber | | Use `eth_*` |
+| erigon\_getLatestLogs | | Use `eth_*` |
+| erigon\_getLogsByHash | | Use `eth_*` |
| debug\_getBadBlocks | | |
| debug\_storageRangeAt | | |
| debug\_getTrieFlushInterval | | |
@@ -71,14 +82,14 @@ See also [interactive Polygon API call examples](/reference/polygon-getting-star
| debug\_traceBlockByNumber | | |
| debug\_traceCall | | |
| debug\_traceTransaction | | |
-| trace\_block | | |
-| trace\_call | | |
-| trace\_callMany | | |
-| trace\_filter | | |
-| trace\_rawTransaction | | |
-| trace\_replayBlockTransactions | | |
-| trace\_replayTransaction | | |
-| trace\_transaction | | |
+| trace\_block | | Use `debug_trace*` |
+| trace\_call | | Use `debug_trace*` |
+| trace\_callMany | | Use `debug_trace*` |
+| trace\_filter | | Use `debug_trace*` |
+| trace\_rawTransaction | | Use `debug_trace*` |
+| trace\_replayBlockTransactions | | Use `debug_trace*` |
+| trace\_replayTransaction | | Use `debug_trace*` |
+| trace\_transaction | | Use `debug_trace*` |
| bor\_getAuthor | | |
| bor\_getCurrentProposer | | |
| bor\_getCurrentValidators | | |
diff --git a/reference/polygon-trace_block.mdx b/reference/polygon-trace_block.mdx
index 6f538a86..e18bc833 100644
--- a/reference/polygon-trace_block.mdx
+++ b/reference/polygon-trace_block.mdx
@@ -6,6 +6,10 @@ description: "Polygon API method that returns traces for all the transactions wi
Polygon API method that returns traces for all the transactions within a specific block. Developers can use the `trace_block` method to gain insight into the behavior of smart contracts within a block, analyze gas usage and optimize their contracts accordingly. This method is only available on an Erigon instance.
+
+**Not available on Polygon.** Chainstack serves Polygon on the Bor client (archive uses Bor with PBSS), which does not implement the Erigon-only `trace_*` namespace. Use [`debug_traceBlockByNumber`](/reference/polygon-traceblockbynumber) with the `callTracer`, which returns equivalent per-transaction call traces for a block on Bor.
+
+
**Get your own node endpoint today**
diff --git a/reference/polygon-trace_transaction.mdx b/reference/polygon-trace_transaction.mdx
index c3aad22f..0e88662f 100644
--- a/reference/polygon-trace_transaction.mdx
+++ b/reference/polygon-trace_transaction.mdx
@@ -6,6 +6,10 @@ description: "Polygon API method that traces a specific transaction. trace_trans
Polygon API method that traces a specific transaction. It provides a detailed record of all the steps taken by the Ethereum Virtual Machine (EVM) during the execution, including all the operations performed and the changes made to the blockchain state. This method is available on Erigon only.
+
+**Not available on Polygon.** Chainstack serves Polygon on the Bor client (archive uses Bor with PBSS), which does not implement the Erigon-only `trace_*` namespace. Use [`debug_traceTransaction`](/reference/polygon-tracetransaction) with the `callTracer`, which returns an equivalent call trace on Bor.
+
+
**Get your own node endpoint today**