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

# Sub-Users

In this section, we'll walk you through the steps for managing sub-users. We recommend reading our 'Sub-Users' introduction beforehand to familiarize yourself with the concept.

{% content-ref url="/pages/8pKoiDpXpxe7vuHC9BF8" %}
[Sub-Users](/proxies/residential/sub-users.md)
{% endcontent-ref %}

***

Navigate to the 'Residential' section on the sidebar menu (<mark style="color:orange;">1</mark>), which brings you to the main dashboard for Residential Proxies.

From there, find the 'Sub-Users' (<mark style="color:orange;">2</mark>) button. Clicking on this button will bring you to the sub-users dashboard.

<figure><img src="https://22873178-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4Y3jlvZjKrqTSLg2hBbJ%2Fuploads%2FfiBx84DXM3FBK9rLMO6q%2FH1.png?alt=media&amp;token=73407da3-541e-4f5f-b8a8-7f5c11f65e7d" alt=""><figcaption></figcaption></figure>

If you haven't created any sub-users yet, you will initially see a brief introduction. By clicking the 'Sub-Users Dashboard' button, you will be directed to the panel where you can create your first sub-user.

<figure><img src="https://22873178-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4Y3jlvZjKrqTSLg2hBbJ%2Fuploads%2FPO6wpEH68IfmwCygqqbZ%2FH2.png?alt=media&amp;token=278c473b-4f30-40a2-8c48-ad43078bbf13" alt=""><figcaption></figcaption></figure>

The 'Create Sub-User' page features three input fields.&#x20;

The first is for the sub-user's username (<mark style="color:orange;">1</mark>), which is used to connect to the proxy.

&#x20;The second field is for setting the password (<mark style="color:orange;">2</mark>).

And the third is 'Assign Traffic' (<mark style="color:orange;">3</mark>). The number entered in this field is the amount of traffic (in GB) that will be deducted from your (the main user's) account and allocated to the sub-user.

After filling out these inputs, click the 'Create' (<mark style="color:orange;">4</mark>) button to finalize the creation of your sub-user.

<figure><img src="https://22873178-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4Y3jlvZjKrqTSLg2hBbJ%2Fuploads%2FnvtsCZnwhmZmdbnhlNEa%2FH3.png?alt=media&amp;token=714f5555-359a-46ca-8cfc-9181f3369266" alt=""><figcaption></figcaption></figure>

Congratulations on creating your first sub-user. The image below illustrates the interface you'll encounter following the creation.&#x20;

It includes:

* a button for adding additional sub-users (<mark style="color:orange;">1</mark>);
* a display panel indicating your main user’s remaining traffic (<mark style="color:orange;">2</mark>);
* a table listing all sub-users with a search feature for easy navigation (<mark style="color:orange;">3</mark>).

Equally crucial are the management buttons (<mark style="color:orange;">4</mark>) adjacent to each sub-user entry, which provide options to create whitelists and generate proxies for them.

<figure><img src="https://22873178-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4Y3jlvZjKrqTSLg2hBbJ%2Fuploads%2FslKCKQSl97fSAlo8Sx7x%2FH4.png?alt=media&amp;token=f4a0a962-a7ae-4637-876e-c80cfc3cd9cb" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.iproyal.com/proxies/residential/dashboard/sub-users.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.