> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/dashboard/oxylabs-dashboard.md).
# Oxylabs Dashboard
## Overview
The updated Oxylabs Dashboard introduces:
* **A credit-based billing model**
* **Real-time spending visibility**
* **Granular instance limits** (monetary, results-based, traffic-based)
* **Automated credential generation**
## Spending Summary
Real-time spending and commitment are shown in the top right corner of the dashboard Overview page.
From the example above, the spending summary includes:
* `Current spending` – funds used ($111.18, 22% of commitment)
* `Commitment` – your budgeted monthly spend ($500)
* `Overusage limit` – additional spending allowed beyond the commitment ($500)
In this instance, $388.82 remains in the budget. Since the `Overusage limit` is $500, the service pauses once total spending reaches $1,000 ($500 commitment + $500 overusage).
## Product Instances Table
{% hint style="info" %}
A product instance is a specific configuration of a service (e.g., Residential Proxies, Web Scraper API, etc.) that includes a unique name, authentication credentials, and a spending limit.
{% endhint %}
The Overview page lists all active instances with their `Usage`, `Spending`, `Limit`, and `Price`. Use the search bar and filters to find instances by `Product`, `Status`, or `Limit`.
## Creating a Product Instance
{% stepper %}
{% step %}
### Start the instance creation
Click "**+ Add product instance**" from the Overview page
{% endstep %}
{% step %}
### Select a product
Choose a product from the list. Products are grouped into categories:
* **Data Collection** (Web Scraper API, Fast Search API, Headless Browser)
* **Proxies & Advanced Proxy Solutions** (Residential, Mobile, Datacenter, ISP Proxies)
{% endstep %}
{% step %}
### Set instance name and credentials
**Instance name**: Choose a descriptive name
**Credentials:** Auto-generated (password can be edited later)
{% endstep %}
{% step %}
### Configure limits & notifications (optional)
To cap usage on a new instance, set up your limits with:
**Limit type**:
* `USD/EUR` (Monetary)
* `Results`
* `GB` (Traffic).
**Period**:
* `Daily`
* `Weekly`
* `Monthly`
* `Lifetime`
Then, choose an option for "**Action for exceeded limit**":
* **Disable instance** when the limit is reached.
* **Send email** alerts without disabling the instance.
{% endstep %}
{% step %}
### Finish instance setup
Click **Create instance** to complete the setup.
{% endstep %}
{% endstepper %}
## Managing Instances
Click any instance to open its detail page. From there, you can:
* Edit the instance name
* Enable, disable, or delete the instance
* Adjust limits
* View or edit credentials
* Access integration examples
* View usage statistics
* View the spending limit progress bar
## Monitoring Spending
### Real-time (current month)
The top bar progress indicator on the Overview page shows real-time spending for the current month.
### Historical data
In the **Spending** tab, view historical data by **Products**, **Instances**, or **Targets**. Switch between `Hourly`, `Daily`, `Weekly`, or `Monthly` views for different data granularities.
## Monitoring Usage
The **Usage** tab displays success rates, response time and other metrics per time interval, target etc. depending on the chosen product.
You can also compare usage breakdowns as shown below:
## Managing IP Products
Pay-per-IP products can be managed directly in the dashboard:
* Datacenter Proxies
* Dedicated Datacenter Proxies
* ISP Proxies
* Dedicated ISP Proxies
Navigate to the relevant instance and select **Proxy list** to manage your proxies.
* **Add/modify** – add new proxies or update existing ones.
* **Refresh** – replace selected proxies with new ones.
* **Remove** – delete selected proxies.
{% hint style="info" %}
**Note:** For any changes to Enterprise Dedicated Datacenter Proxies, [contact support](mailto:support@oxylabs.io) or your dedicated account manager.
{% endhint %}
### IP product billing
Pay per IP products (Datacenter Proxies, ISP Proxies, Dedicated Datacenter Proxies, Dedicated ISP Proxies) are billed daily. The daily charge is calculated by dividing the total monthly cost by `30` days, regardless of the calendar month.
**Example:** A monthly IP cost of `$300` equates to a daily charge of `$10` ($300 ÷ 30 days).
{% hint style="info" %}
**Note:** Enterprise Dedicated Datacenter Proxies are billed monthly.
{% endhint %}
## Settings
**Settings** section is found in the Overview and include **Settings**, **Invoices**, **Team**, and **Email notifications**.
Here users can:
* Change password
* Select region
* View/download invoices
* Manage team members
* Configure email notifications
### Managing team members
Invite team members to join your dashboard through the **Team** space. Invited members get access to the dashboard and its features, excluding subscription management and member invitations.
### Email notifications
The **Email notifications** tab lets you configure spending limit alerts (e.g., notifications at `50%`, `80%`, or `100%` of your spending limit) and add the email addresses that should receive them.
## Dashboard API
To access select product usage statistics programmatically outside the Oxylabs Dashboard and integrate the real-time metrics into your internal systems, see Oxylabs [Dashboard API](/dashboard/dashboard-api.md).
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://developers.oxylabs.io/dashboard/oxylabs-dashboard.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.