Skip to content

Commit 1bc51c2

Browse files
docs: document residential proxy IP rotation behavior
Customers are confused when they see different IPs across browser tabs with residential proxies. Add a warning callout, an "IP Rotation Behavior" section explaining per-connection rotation, and a comparison table (residential vs ISP) so users can pick the right proxy type. Also add an Info callout to the proxies overview page. Made-with: Cursor
1 parent 86f5aab commit 1bc51c2

2 files changed

Lines changed: 25 additions & 0 deletions

File tree

proxies/overview.mdx

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,10 @@ Kernel supports four types of proxies:
1515

1616
Datacenter has the fastest speed, while residential is least detectable. ISP is a balance between the two options, with less-flexible geotargeting. Kernel recommends to use the first option in the list that works for your use case.
1717

18+
<Info>
19+
Datacenter and ISP proxies provide a **stable exit IP** that stays consistent across all connections. Residential proxies use **rotating exit IPs** that may change per connection — see [Residential Proxies](/proxies/residential#ip-rotation-behavior) for details.
20+
</Info>
21+
1822
## Create a proxy
1923

2024
Create a proxy configuration from the types above that can be reused across browser sessions:

proxies/residential.mdx

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,27 @@ title: "Residential Proxies"
44

55
Residential proxies route traffic through real residential IP addresses. They support advanced targeting options including city, state, and operating system.
66

7+
<Warning>
8+
Residential proxies use **rotating exit IPs** — each new connection may route through a different residential IP address within your targeted region. This means different browser tabs or requests to different websites within the same session can show different public IPs. If you need a consistent IP address across all connections, use an [ISP proxy](/proxies/isp) instead.
9+
</Warning>
10+
11+
## IP Rotation Behavior
12+
13+
Residential proxies assign a new exit IP for each new TCP connection. In practice:
14+
15+
- **Same website across tabs**: Tabs connecting to the same domain typically share a TCP connection (via HTTP connection pooling), so they usually see the same IP.
16+
- **Different websites across tabs**: Tabs connecting to different domains open separate connections, so they will likely exit through different residential IPs.
17+
- **Reconnections**: If a connection is closed and re-established (e.g., after a timeout or page idle), the new connection may get a different exit IP.
18+
19+
This behavior is inherent to residential proxy networks, where traffic is routed through real consumer devices that come online and offline dynamically.
20+
21+
| Feature | Residential | ISP |
22+
| --- | --- | --- |
23+
| IP stability | Rotating — changes per connection | Static — consistent across all connections |
24+
| IP authenticity | Real consumer devices | ISP-assigned IPs hosted in data centers |
25+
| Best for | Web scraping, data collection, avoiding rate limits | Session-based workflows, account management, login flows |
26+
| Geo-targeting | Country, state, city, ZIP, ASN | Country |
27+
728
## Configuration
829

930
Create a residential proxy with a target country:

0 commit comments

Comments
 (0)