Countries and sessions
All settings live in the username. Tack short pieces onto it with hyphens, and the network applies them to every connection.
Available pieces
| Piece | Effect |
|---|---|
country-us | Where traffic exits, as a two-letter code. Codes are on the locations page. |
state-california | State or region, written out in lowercase. Residential only, and only after a country. |
city-losangeles | City, lowercase without spaces. Residential only, and only after a country. |
session-a1b2c3d4 | Any eight characters you like. Same value, same IP; new value, new IP. |
time-600 | How many seconds to hold the IP. Mobile uses time-short or time-long instead. |
Rotating: a new IP each time
Skip the session and the time. With just a country, or no extras at all, every connection gets another IP.
Sticky: one IP for a while
Include a session and a time. Each proxy type expects its own order, so follow the example for yours:
| Proxy type | Sticky username | Remember |
|---|---|---|
| Residential | USERNAME-country-us-state-california-city-losangeles-time-600-session-a1b2c3d4 | Time goes before the session. |
| Residential Lite | USERNAME-country-us-time-600-session-a1b2c3d4 | Country, no city. |
| Mobile | USERNAME-country-us-mobile-true-package-mobile-session-a1b2c3d4-time-short | Session goes before time, which is short or long. |
| Mobile USA | USERNAME-session-a1b2c3d4 | No country needed: all IPs are American. |
| Unlimited Datacenter | USERNAME | Nothing to add: each line of your list is a separate US IP. Reuse a line to keep its IP. |
| IPv6 Datacenter | USERNAME-country-us-time-600-session-a1b2c3d4 | Country, no city. |
| IPv6 Residential | USERNAME-country-us-package-ipv6-time-600-session-a1b2c3d4 | Do not remove the package-ipv6 piece. |
No need to type any of this: the generator on your plan page builds usernames for one proxy or a thousand.
Common mistakes
- A session value is just a name you invent. Any eight letters or digits work; requests that should share an IP must use the same name, and requests that should not must use different ones.
- Most programs reuse open connections. On a rotating username, the IP changes with each new connection, not with every request sent over one that is already open.
- Sticky IPs can drop out early: if the household or phone connection goes offline, your next request lands on a new IP.
- State and city only work after a country, and must be lowercase with no spaces.
- Case matters and pieces are joined with hyphens. One missing hyphen or a capital letter, and the piece is ignored or the login fails.
Unfamiliar terms? The glossary covers sticky session, session ID and geo-targeting.
Need a hand? Open the chat bubble or email support@proxies.boo.