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

# Attach external proxy

Learn how to attach a custom proxy from a third-party provider to your browser profile.

If you have an existing proxy subscription from an external provider, you can connect those proxies directly to Incogniton. This page covers both ways to do it: adding a single proxy and adding multiple proxies at once.

### Add a single proxy

Open **Proxy Library** from the left-side menu and click **+ New proxy** in the top right. This opens the Add proxy form. If you need to add multiple proxies at once, there is a bulk add option covered in the next section.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FH8yXxFJjKNEduZ4cdtjg%2Fuploads%2F5Wof9uNTkvYYqtxyxQK6%2Fadd-proxy.mp4?alt=media&token=3da25719-58ac-45d1-aca0-17301a192833>" %}

{% stepper %}
{% step %}

#### Enter proxy details

Give the proxy an optional display name, then select your Connection type — **HTTPS** or **SOCKS5** depending on what your provider supports. Enter the proxy address in the **Proxy (ip:port)** field, followed by your **Proxy username** and **Proxy password**.

You can also paste the full credentials string directly into the **ip:port** field using the format `ip:port:username:password` and Incogniton will populate the remaining fields automatically.
{% endstep %}

{% step %}

#### Configure group and proxy provider

Use the **Group** dropdown to organise the proxy into an existing group, or leave it as **Unassigned**.

The **Proxy provider** dropdown controls which database Incogniton uses to validate the proxy's geolocation. **Main provider** uses IPstack by default. If a proxy validates against the wrong location due to a vendor data issue or a database error, switch to **Backup provider** or **Second backup provider** to re-validate the same proxy against a different source.

Optionally, add any reference notes in the **Notes** field.
{% endstep %}

{% step %}

#### Enable rotating proxy (optional)

If your provider supports proxy rotation via an API, toggle on **Rotating proxy** and enter your provider's **Proxy rotation API url**. Incogniton will call this URL to get a new IP when a rotation is triggered.
{% endstep %}

{% step %}

#### Check and Add proxy

Click **Check** to verify the connection. If you want to stage multiple proxies before saving, click **Add to list** to queue this proxy and continue adding more. Once you are done, click **Add** to save the proxy to your library.
{% endstep %}
{% endstepper %}

### Add bulk proxies

If you have a list of proxies to add at once, use the bulk add option instead. From the Add proxy form, click **Bulk add** at the bottom left.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FH8yXxFJjKNEduZ4cdtjg%2Fuploads%2Fl7MC9yv6oHAvJmbUBuB9%2Fadd-bulk-proxy.mp4?alt=media&token=710ff058-6e9d-430f-97f5-cc9932930ed9>" %}

{% stepper %}
{% step %}

#### Paste your proxies

Paste your proxy list into the text field, one proxy per line, using the format `ip:port:username:password`. You can load your proxy list from a CSV file by selecting **Load from file** and choosing your file. Each row in the CSV should follow the same format.
{% endstep %}

{% step %}

#### Assign a group

Use the **Group** dropdown to assign all imported proxies to a group, or leave them as Unassigned.
{% endstep %}

{% step %}

#### Add the proxies

Click **Add** to save all proxies to your Library at once.
{% endstep %}
{% endstepper %}

Once added, your proxies appear in the **Proxy Library** under the **All Proxies** tab. From there you can assign them to profiles, organise them into groups, and manage them without re-entering credentials.

To assign a proxy to a profile, open the profile editor, go to the **Proxy** tab, select **Proxy Library**, and click **Select from Proxy Library**.