---
url: https://docs.smoxy.eu/organization/ip-lists.md
---
# IP Lists

The **IP Lists** page lets you create and manage named lists of IP addresses that can be referenced from [Access Rules](/rules/access-rules) and [Conditional Rules](/rules/conditional-rules). Instead of pasting the same IP addresses into every rule, you define them once and reuse the list across zones.

***

### Creating and Managing IP Lists

On the **IP Lists** page in your organization settings you can:

* **Create a new list** - give it a name (e.g. `office_ips`, `trusted_partners`) and add one or more IP addresses or CIDR ranges.
* **Add or remove IPs** at any time. Changes apply automatically wherever the list is referenced.
* **Reference the list** from Access Rules or Conditional Rules by selecting it instead of typing addresses.

***

### Common Use Cases

#### Bypass Basic Auth for trusted IPs

If your application is protected by Basic Authentication but your team or partners shouldn't be prompted, reference an IP list in a Conditional Rule that disables Basic Auth for matching addresses.

#### Allow access to a maintenance site

Route public traffic to a maintenance page while everyone on the IP list continues to see the live application - one Conditional Rule, one IP list, no per-zone duplication.

#### Whitelist trusted traffic before security checks

Use Access Rules with an IP list to allow internal or partner traffic before any WAF or rate-limiting evaluation. Combine with **Stop Mode** to skip further rule processing for those visitors.

#### Custom routing or load balancing

In advanced setups, IP lists can drive routing decisions - sending specific clients to a dedicated origin, staging environment, or backend pool.

***

### Benefits

* **Centralized management** - define IP groups in one place rather than duplicating them across rules and zones.
* **Consistency across zones** - referencing the same list everywhere guarantees identical behavior, and updates propagate instantly.
* **Simpler rule configuration** - rule conditions stay short and readable; the IP list does the heavy lifting.

***

### Related

* [Access Rules](/rules/access-rules) - security rules that match IP, country, header, or path
* [Conditional Rules](/rules/conditional-rules) - zone configuration overrides driven by request conditions
