IP Lists
The IP Lists page lets you create and manage named lists of IP addresses that can be referenced from Access Rules and Conditional Rules. Instead of pasting the same IP addresses into every rule, you define them once and reuse the list across sites.
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-site 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 sites.
- Consistency across sites — 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 — security rules that match IP, country, header, or path
- Conditional Rules — site configuration overrides driven by request conditions
