Guides

Proxy Manager: importing a list, checking, and assigning proxies

Proxy Manager: importing and configuring proxies in Undetectable
Proxy Manager: importing a list, checking, and assigning proxiesGuides

You received proxies from a provider and want to connect them to Undetectable profiles. With one address, everything looks simple. When there are dozens of addresses, questions appear: which format to choose, how to distribute connections between profiles, and why the IP has not changed after a successful import?

Proxy Manager helps you store connections in one place, check them, and use them in profiles. In this guide, we will go through the full process: prepare a list, import it, check the connections, and assign proxies to existing or new profiles. At the end, we will cover the errors that most often stop the setup process.

The main rule: adding a proxy, checking it, and assigning it to a profile are three separate actions. An entry in Proxy Manager does not by itself change the connection of an already created profile.

Adding, checking, and assigning a proxy are three separate actions

What to prepare before adding

Open your proxy provider’s account dashboard and find the connection parameters. You will need:

Parameter What it means
Type, or protocol For example, HTTP or SOCKS5. Choose the protocol the provider issued for this connection
Host The IP address or domain of the proxy server
Port The connection port
User / Login and Password The proxy username and password. They may differ from the login details for the provider’s dashboard
IP Change Link A link for changing the IP if the provider supports this function. It is not required for a regular connection

Some proxies authorize the user by the computer’s external IP. In this case, a username and password may not be required, but your current external IP must be allowed in the provider’s dashboard. After changing networks or connecting to a VPN, this list may need to be updated.

Host and external IP are different concepts. Host shows where Undetectable connects. The external IP is the address the website sees. With providers that use a shared gateway, several connections may have the same Host while accessing the internet through different IPs. The opposite situation is also possible: different connection lines use the same exit address.

If the list contains different protocols, it is more convenient to split it into several groups for the first import. This makes it easier to check the settings and find an error.

For SOCKS5, separately confirm UDP support with your provider. If your task requires it, configure the corresponding option according to the instructions below.

How to add one proxy

Start with one connection if you are working with the provider for the first time. After a successful check, you can move on to the list.

  1. Open the Proxy section in the Undetectable side menu.
  2. Click Add new proxy — the plus button.
  3. Fill in Name. Choose a name by which you will later recognize the connection, for example, DE-SMM-01.
  4. Specify Type, Host, Port, User, and Password.
  5. If the provider has an IP change link, paste it into IP Change Link. Otherwise, leave the field empty.
  6. Click Check to check the connection, then save it with Save Proxy.

For supported formats, you can paste the entire connection line into the Host field: the app will distribute the data across the fields. For example, a line like host:port:login:password fills in the address, port, username, and password. After pasting, still check the result and the selected protocol.

If the save button is unavailable, check the required fields, including Name. Successful line recognition does not mean the form is fully completed.

SOCKS5 with UDP: when to enable it and how to check it

Undetectable supports SOCKS5 proxies with UDP. This mode allows WebRTC to route the connection through the proxy and supports QUIC — the transport for HTTP/3. WebRTC is used, for example, for audio and video communication in the browser.

First, confirm with the provider whether the specific connection supports UDP relay / UDP ASSOCIATE. In SOCKS5, TCP and UDP transmission are separate operations: the availability of regular pages does not prove that UDP also works. The plan name “SOCKS5” alone is not enough to choose this mode.

How to enable it

In the SOCKS5 settings, check Proxy with UDP support and run the check. A green UDP indicator confirms support; a red one means it has not been confirmed. After checking, save the connection and assign it to a profile.

Do not enable the option for proxies without UDP: WebRTC will stop working. The checkbox sets the application’s operating mode, but it does not add a missing capability to the provider’s server.

You can also set the option in the default settings for new sessions. Use this for a uniform set of connections with confirmed UDP; check a mixed list separately. First test one profile, then apply the setting to a group.

Enabling UDP support for SOCKS5

How to check inside a profile

After assigning it, launch the profile and check the external IP and WebRTC in BrowserLeaks. For QUIC, use the corresponding test or DevTools on a Google website: open Network, enable the Protocol column through the header context menu, and reload the page. The h3 value for a request means HTTP/3 is being used.

Do not require h3 for every request: the protocol depends on the website and network route. QUIC may not work because of a VPN even if the browser is functioning properly. Do not change settings for the entire group based on one test result.

If UDP is marked red while pages open, confirm UDP support with the provider and check network restrictions. If WebRTC disappeared after enabling the mode, return to regular SOCKS5 without this option and repeat the check. If UDP is confirmed but h3 does not appear, check QUIC, service availability, and VPN influence separately.

UDP support works in test mode. If problems occur, report the connection type, UDP check result, whether a VPN is present, and the reproduction scenario to support.

How to import a proxy list

Proxy list import is available on all paid plans: Base, Professional, and Custom. This function is unavailable on Free. Before preparing the list, check your plan; a feature comparison is available on the pricing page.

1. Prepare connection lines

One line must contain one proxy. For example:

192.0.2.10:8000:demo:example

192.0.2.11:8000:demo:example

Here and below, training addresses and credentials are used: you cannot connect through them. For actual use, substitute the values from your provider.

Before pasting, remove table headers, numbering, and explanations. If you copy data from Excel or Google Sheets, make sure tabs have not appeared between values instead of the expected delimiter.

2. Open import and choose the type

In Proxy Manager, click Import. In the Type field, specify the protocol of the imported connections.

The protocol should not be chosen based on the website you plan to open. For example, HTTPS in a website address does not mean you should automatically choose HTTPS in the proxy settings. Use the provider’s parameters as your reference.

3. Match Format to your list

The Format field describes the order of data and delimiters in each line. Values in curly braces are field labels. They do not need to be added to real addresses.

Provider line Format in the import window
192.0.2.10:8000:demo:example {host}:{port}:{user}:{pass}
demo:example@192.0.2.10:8000 {user}:{pass}@{host}:{port}
192.0.2.10:8000|demo:example {host}:{port}|{user}:{pass}
192.0.2.10:8000 {host}:{port}

Choosing the type and line format when importing proxies

The option without a username and password is suitable when the connection truly does not require this data, for example, with IP authorization. Do not remove credentials from a line just to use a shorter format.

Choose a ready-made template or create your own using field labels. The interface also provides {name}, {type}, and {link} — for the name, protocol, and IP change link.

For bulk SOCKS5 import with UDP, the socks5u label is used; it is also intended for API use. Example training line:

socks5u://192.0.2.10:8000:demo:example

For this line, the parsing template must account for the type and the :// delimiter: {type}://{host}:{port}:{user}:{pass}. Do not paste it under a template that starts with {host}: the protocol prefix is a separate part of the data. After a test import, check the recognized type and UDP support before assigning the entire group.

Delimiters must match literally. A colon, the | character, and @ are not interchangeable. If one of them appears inside the password, check the parsing especially carefully. For the first such connection, it is more convenient to use the separate fields in the add form.

4. Configure names

The Start ID field sets the starting value of the counter for {id}. Name Template defines the names of imported entries.

For example:

Start ID: 1

Name Template: SMM-DE-{id}

This will give you sequential names for this group. The name helps you choose the right proxy, but it does not change the country, IP, or connection parameters.

It is useful to include the project, purpose, and number in the name: ClientA-DE-01, QA-US-01. Do not add the password to the name even if the corresponding macro is available: names more often appear in screenshots and work chats.

In an extended format, a line may contain its own name and type:

{name}:{type}:{host}:{port}:{user}:{pass}:{link}

When this template is selected, the general Type, Start ID, and Name Template fields become unavailable: the data is taken from the list. This is the expected form behavior. For the first import, it is easier to use the basic format with a separate protocol selection.

5. Add the list and check the result

Paste the lines into the text field or upload a prepared file via Select file. In both cases, the content must match the selected Format. A regular table with arbitrary columns does not become a suitable list just because it has a CSV extension.

Before a large import, we recommend adding two or three lines. Click Add Proxy, find the new entries, and check:

  • whether all expected connections appeared;
  • whether Host, Port, and type are filled in correctly;
  • whether the entries received clear names;
  • whether the username or part of the password ended up in a neighboring field.

If the test group is recognized correctly, import the remaining lines. Exclude already added lines from the next batch so you do not create extra entries.

How to check proxies and read the result

Select the added entries and click Check proxy. You can run the check for a group, so there is no need to open each connection separately.

The table has a Status column. The Active status means the connection check was successful. Error indicates a problem that needs to be fixed before using the proxy. Do not treat an empty value as confirmation that the proxy works: run the check and wait for the result.

The Error status by itself does not prove a failure in Undetectable: the proxy may be unavailable from your network. Below, in the “Common problems” section, you will find a check procedure with VPN, without VPN, and in another program on the same computer.

For SOCKS5 with UDP, additionally check the UDP indicator: the general Active status does not replace this check.

Proxy check: Active status and availability of the required website

When checking, pay attention to the external IP and geography. Recheck connections after changing credentials, renewing the service, or taking a long break from work.

A working proxy does not guarantee access to any website. The connection check does not evaluate the entire IP history and does not promise the absence of captcha or restrictions from the target platform. Therefore, after assignment, one more step is needed — checking inside the profile itself.

If the city differs from the one specified by the provider, first compare data from several sources. Geolocation databases may identify the same address differently; this discrepancy is described separately in the proxy checker documentation. A country mismatch that is important for your task should already be discussed with the provider before you start working.

How to assign a proxy to a profile

One new or existing profile

Open profile creation or the settings of an existing profile. On the main Main tab, find the proxy list and select the saved connection by name. Check the connection via Check Proxy, then save the settings or create the profile.

If No Proxy is selected instead of a proxy, the profile uses the regular network connection available to it. The presence of other entries in Proxy Manager does not affect this.

If the proxy has not been saved yet, you can add it directly from the profile settings via New Proxy. This path is convenient for a one-time setup; the shared list is easier to manage through the manager. Both scenarios are described in the proxy setup guide.

After saving, launch the profile and open an IP checking service inside its window. Make sure you see the expected exit address and country. Then check whether the required website is available. Only after that should you proceed to authorization and main work.

Do not check the result in a regular browser on the computer: it may have a different route to the internet.

Assigning a saved proxy to a profile

Several existing profiles

For bulk assignment, open Profiles Manager, select the required profiles, and open the context menu with the right mouse button. Select Set Proxy / Set proxy and specify the connections.

Undetectable supports sequential assignment of several selected proxies to several profiles.

For the first distribution, take a small group with the same number of profiles and proxies. After applying, open the settings of each profile in this group and check the match. If the task requires a strict pair “specific account — specific proxy,” do not rely on the assumed selection order: verify the result by names.

Before changing the connection, finish work and close the corresponding profiles. After assignment, launch them again and check the exit IPs.

One proxy can be used in several profiles, but separate profiles do not make a shared IP unique. For tasks where different exit addresses are needed, check the actual IPs as well as the provider’s terms for simultaneous connections.

Proxies during bulk profile creation

If the profiles do not exist yet, use Mass Creator. In the Advanced section, there is a Proxy field where you can choose connections for the created group.

Set the other parameters and click Generate. Check the prepared list before the final Create. After creation, make sure the required proxies are assigned to the profiles. This scenario is covered in more detail in the mass creation instructions.

Do not mix two actions: importing into Proxy Manager adds to the list of available connections, while selecting a proxy in Mass Creator sets connections for future profiles.

How to change and maintain saved proxies

Change a shared entry or replace the proxy for one profile

These are different tasks.

If the provider changed the port or credentials for an existing connection, you can edit the corresponding entry in Proxy Manager. Changing a saved proxy affects the profiles linked to it. Before editing, look at the Profiles column, which shows the number of profiles using the entry.

If you need to move only one profile to another connection, add a new proxy and select it in that profile’s settings. This way, you keep the previous parameters for the others.

Changing a shared proxy entry affects linked profiles

After any change, repeat the connection and exit IP check. Do not use deleting an entry from the manager as a way to guarantee disabling the proxy for a profile: change the assignment directly in its settings and check the result.

Export and deletion

Proxy export is available on the paid Professional and Custom plans. This function is unavailable on Free and Base: having import on Base does not mean export is also included in the plan. You can check the terms on the pricing page.

Proxy import and export on Undetectable plans

To export, select the required proxies, open the context menu, and choose Export. Editing and deletion are available through actions with selected entries. The main operations are listed in the Proxy Manager guide.

The exported list may contain usernames, passwords, and IP change links. Store it as access data and do not send it to public chats. Deleting a proxy from Undetectable does not cancel a rental or subscription with the provider — that is a separate operation in the provider’s dashboard.

Mobile proxies and IP change

If the provider issued a URL for changing the address, add it to IP Change Link. This field needs the provider’s control URL specifically, not the server address, personal dashboard, or IP checking website.

To change the address, use Change IP, wait for the request to complete, and recheck the external IP. Do not assume it changed immediately after clicking.

Filling in IP Change Link by itself does not mean the address will automatically update before every regular profile launch. Cookies Bot has a separate option for using the link before launch — this is an independent setting. More details are in the mobile proxy instructions.

For work that requires a persistent IP, confirm the rotation parameters and address hold duration with the provider. Plan IP changes between work sessions: switching during authorization or actions may disrupt the connection and trigger an additional check. Practical recommendations are collected in the mobile proxy guide.

Two settings worth knowing about

In Settings → Advanced, there is an option Do not run profile if proxy is not active — it prevents a profile from launching when the proxy is inactive. It is useful when it is important to check the availability of the assigned connection before starting work.

This is a launch restriction. It should not be treated as a promise of continuous connection monitoring throughout the entire session.

In the main app settings, there is an IP checker selection. It refers to the IP checking service. Changing the checker does not replace the proxy and does not fix an incorrect password or expired traffic. If the check results raise doubts, compare them with a check inside the profile and the provider’s data.

Other connection parameters do not need to be changed for a regular import. If the basic checks did not help, send the error symptoms to support and clarify which settings are suitable for your case.

Can a proxy be added through partner integration?

Yes. Proxy Manager has Partners proxy. For a supported provider, you can connect an account via an API key, get available parameters, create proxies, and add them to the manager.

The set of fields depends on the integration. Check the balance, available traffic, and provider terms before generation. After adding, the same steps remain: check the connection, assign the proxy to a profile, and check the IP inside it. Examples of integrations are available in the proxy partners overview.

Common problems and what to check

What happens What to do
The list is not imported or values end up in the wrong fields Compare Format with one original line: data order, delimiters, absence of headers and extra spaces. Try adding one entry manually
The proxy was added but has Error status Check the protocol, Host, Port, and credentials against the provider’s dashboard. Check the validity period, balance, or traffic, and with IP authorization, the allowed external address
The proxy works in the manager, but the profile shows another IP Open the settings of this exact profile, check the selected entry, save changes, and restart the profile. Check the IP inside its window
Several profiles show the same IP Check the assignment and actual exit addresses. Different proxy names or different usernames do not by themselves guarantee different IPs
Status is Active, but the target website does not open Check another website in the same profile. If the connection works, investigate availability of the specific resource and address restrictions with the provider
The city in the check differs from the provider’s dashboard Compare geolocation databases. If the discrepancy affects the task, confirm the geography with the provider
After changing one entry, the problem appeared in several profiles Check whether they use a shared saved proxy. Restore the correct parameters or assign a separate connection to the required profile
The profile does not launch when there is a proxy error Check the option that prevents launch with an inactive proxy. First restore the connection
Change IP does not change the address Check the control link, request frequency limits, and rotation mode with the provider. Wait for the change to complete and repeat the check

The proxy returns an error: how to find the cause

A connection error by itself does not mean the cause is in Undetectable. Access to the proxy may be restricted by the internet provider or the proxy provider. Even a “working” status in the seller’s dashboard does not guarantee that the server is available specifically from your computer and through your network.

Compare operation with and without a VPN. On the same computer, repeat the check of the same proxy with the VPN disabled and enabled. Keep the same protocol, address, port, and credentials. If the proxy uses IP authorization, remember that a VPN changes the external address: it must also be allowed in the provider’s dashboard, otherwise the comparison will be incorrect.

Check the proxy in another program on the same computer. Explicitly configure the same connection in it and repeat the check with the same VPN state. Opening a website in a regular browser without a configured proxy is not enough. A check on another device or on the provider’s website does not replace this test: network conditions may differ.

Compare the results. If the proxy does not connect in both programs, the cause may be the network, credentials, or proxy provider restrictions. If it works only with VPN or only without it, this is a reason to check the network route and access restrictions. If, under the same conditions, it works in another program but not in Undetectable, send the results to Undetectable support: this will help narrow down the cause.

When contacting support, attach the results of all comparisons: with and without VPN, in Undetectable and in another program on the same PC. Specify the name of the second program and the exact error text. One Error status alone cannot unambiguously determine whose side the problem occurred on.

If you need support help, describe at which stage the error occurs: import, check in the manager, profile launch, or website opening. Specify the OS, Undetectable version, protocol, and error text. Before sending screenshots, hide passwords and control links.

Check before starting work

Setup is complete when all five points are done:

  • The list has been imported without errors in addresses, ports, and credentials.
  • The required proxies have passed a fresh connection check.
  • Each profile has the required connection assigned, and changes have been saved.
  • Inside launched profiles, exit IPs and geography have been checked.
  • The target website opens, and the rotation rules are suitable for your work session.

Start with one profile and one checked connection. When this path works, repeat it for a small group and only then distribute the entire list — this makes it easier to notice a format or assignment error before starting work with accounts.

Undetectable Team

Undetectable Team

Anti-detection Experts

Related posts

View all articles

Join 450,000+ users who chose Undetectable

  • Advanced anti-detection technology
  • Unlimited local profiles from $49
  • The perfect solution for multi-accounting
Get started for Free
Undetectable