> For the complete documentation index, see [llms.txt](https://docs.shieldproxies.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shieldproxies.com/troubleshooting/proxies-not-working.md).

# Proxies Not Working

Troubleshoot proxies that are failing to connect or work as expected.

If your proxies are not working, isolate the problem before assuming the proxy itself is offline.

{% stepper %}
{% step %}

### Check your account or data balance

For Residential proxies, [check your remaining data](https://docs.shieldproxies.com/dashboard/view-data-usage.md).
{% endstep %}

{% step %}

### Confirm the proxy configuration

Verify the proxy host, port, protocol, credentials and session type.

Review [Proxy Formats: Rotating, Sticky & ISP](https://docs.shieldproxies.com/using-your-proxies/proxy-formats-rotating-sticky-isp.md). If you see **407 Proxy Authentication Required**, use [Proxy Authentication & 407 Errors](https://docs.shieldproxies.com/troubleshooting/proxy-authentication-and-407-errors.md).

If you recently refreshed Residential credentials, [generate a new Residential proxy list](https://docs.shieldproxies.com/using-your-proxies/generate-residential-proxies.md) before testing again.
{% endstep %}

{% step %}

### Test the proxy independently

Use [Test Your Proxies](https://docs.shieldproxies.com/using-your-proxies/test-your-proxies.md) to check whether the proxy connects outside your application.

If the proxy passes the tester but fails in your app or on a website, follow [Proxy Works in Tester but Not in App or Site](https://docs.shieldproxies.com/troubleshooting/proxy-works-in-tester-but-not-in-app-or-site.md).
{% endstep %}

{% step %}

### Identify the error

Review [Common Proxy Errors](https://docs.shieldproxies.com/troubleshooting/common-proxy-errors.md) for **403, 407, 429, 5xx, timeout, connection refused, reset, or TLS errors**.
{% endstep %}

{% step %}

### Check whether the issue is target-specific

A proxy can be online but blocked or rate-limited by a particular website. Test an unrelated destination as well.

For ISP products that work generally but fail on a target, see [ISP Proxies Blocked on a Target Site](https://docs.shieldproxies.com/troubleshooting/isp-proxies-blocked-target-site.md).
{% endstep %}

{% step %}

### Check sticky or rotating behavior

If the issue is that an IP rotates unexpectedly or does not rotate as expected, use [Sticky & Rotating Session Troubleshooting](https://docs.shieldproxies.com/troubleshooting/sticky-and-rotating-session-troubleshooting.md).
{% endstep %}

{% step %}

### Contact support

If the issue continues, [open a support ticket](https://docs.shieldproxies.com/support-and-community/open-support-ticket.md) with the information needed to reproduce the issue.
{% endstep %}
{% endstepper %}

## What to include with a technical issue

Include where relevant:

* product and proxy pool
* affected proxy or **ISP Order/Transaction ID** for ISP issues
* HTTP/HTTPS or SOCKS5 protocol
* username/password or IP-whitelist authentication method
* requested country, state or city
* rotating or sticky session type
* target website or domain
* browser, bot, scraper or application being used
* exact error message or HTTP status
* proxy tester result
* whether the proxy works on another destination
* when the issue started
* whether it happens always or intermittently

{% hint style="warning" %}
Never send full payment-card details, wallet seed phrases, API secrets, cookies, or other unrelated sensitive credentials when troubleshooting.
{% endhint %}
