From e38752ec0b720a889fcb0e46524e463ca39d1cd8 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Tue, 7 Apr 2026 11:33:59 +0000
Subject: [PATCH] Document PAC proxy auto-configuration mode in proxy settings

Generated-By: mintlify-agent
---
 get-started/configure/proxy-config.mdx | 38 ++++++++++++++++++--------
 1 file changed, 26 insertions(+), 12 deletions(-)

diff --git a/get-started/configure/proxy-config.mdx b/get-started/configure/proxy-config.mdx
index 82a85ebc..8a39ce55 100644
--- a/get-started/configure/proxy-config.mdx
+++ b/get-started/configure/proxy-config.mdx
@@ -12,7 +12,7 @@ Starting from v3.1.0+, **System Proxy is enabled by default for new users** and
 
 Below are steps for configuring your proxy settings at different levels within Bruno.
 
-## 1. Accessing Proxy Settings
+## 1. Accessing proxy settings
 
 1. Open Bruno.
 2. Click on the **Preferences** section from the bottom left corner.
@@ -21,33 +21,47 @@ Below are steps for configuring your proxy settings at different levels within B
 
 ![proxy-settings](/images/screenshots/get-started/config/settings/proxy-settings.webp)
 
-## 2. Configuring Proxy Mode
+## 2. Configuring proxy mode
 
-Bruno provides three options for proxy mode:
+Bruno provides four options for proxy mode:
 
 - **Off**: Disables proxy usage.
-- **On**: Enables proxy and routes requests through the configured proxy.
+- **On**: Enables proxy and routes requests through a manually configured proxy.
 - **System Proxy**: Uses the system-wide proxy settings.
+- **PAC**: Uses a Proxy Auto-Configuration (PAC) file to determine which proxy to use for each request.
 
-Select **On** if you want to configure a custom proxy.
+Select **On** if you want to configure a custom proxy, or **PAC** if you have a `.pac` file that defines proxy rules.
 
-## 3. Selecting Proxy Protocol
+## 3. Configuring PAC proxy
 
-Bruno supports different proxy protocols. Choose one of the following:
+If you select **PAC** mode, you can provide a PAC file in two ways:
+
+- **URL**: Enter the URL to a remote PAC file (e.g., `https://example.com/proxy.pac`). Supported URL schemes are `http://`, `https://`, and `file://`.
+- **File**: Click **Choose file...** to browse and select a local `.pac` file from your filesystem.
+
+PAC files contain JavaScript that determines which proxy server (if any) should be used for a given URL. This is commonly used in corporate environments where different proxy servers handle different network destinations.
+
+<Note>
+The proxy configuration is not saved until a valid PAC URL or file is selected. If you switch to PAC mode without providing a source, the previous proxy settings remain active.
+</Note>
+
+## 4. Selecting proxy protocol
+
+When using **On** (manual) mode, you can choose from the following proxy protocols:
 
 - **HTTP**
 - **HTTPS**
 - **SOCKS4**
 - **SOCKS5**
 
-## 4. Entering Proxy Details
+## 5. Entering proxy details
 
 Fill in the required fields:
 
 - **Hostname**: The proxy server's domain or IP address (e.g., `example.com`).
 - **Port**: The port number for the proxy connection (e.g., `3000`).
 
-## 5. Enabling Authentication (Optional)
+## 6. Enabling authentication (optional)
 
 If your proxy requires authentication:
 
@@ -55,7 +69,7 @@ If your proxy requires authentication:
 2. Enter the **Username**.
 3. Enter the **Password** (Click the eye icon to reveal the password if needed).
 
-## 6. Configuring Proxy at Collection Level
+## 7. Configuring proxy at collection level
 
 There may be instances in which your collection needs to use a different proxy than what you have configured globally. Configuring proxy settings at the collection level will override any configuration you've made in the preferences section.
 
@@ -66,7 +80,7 @@ Below are instructions on proxy settings at the collection level:
 
 ![collection-proxy](/images/screenshots/get-started/config/proxy/3-collection-proxy.webp)
 
-### **Choose the Configuration Mode:**
+### Choose the configuration mode
 
 - **inherit**: Uses the main proxy settings from Preferences.
 - **Enabled**: Enables a custom proxy for this collection.
@@ -76,7 +90,7 @@ Below are instructions on proxy settings at the collection level:
 4. Enter the **Hostname, Port, Protocol, Username, and Password** if needed.
 5. Click **Save** to apply the settings.
 
-## 7. Saving Proxy Configuration
+## 8. Saving proxy configuration
 
 After entering the proxy details, click the **Save** button to apply the changes. Your proxy settings are now configured in Bruno.