Edge Rules Ordering

Documentation Index

Fetch the complete documentation index at: https://docs.bunny.net/llms.txt

Use this file to discover all available pages before exploring further.

​

How Edge Rules Are Ordered

Edge Rules execute in the order defined by the OrderIndex. Rules are always processed from the smallest to the largest OrderIndex value:

• A rule with OrderIndex = 1 will execute before a rule with OrderIndex = 2.
• All rules are executed sequentially based on their index.

This allows you to control which rules should apply first, which is especially important when multiple rules affect the same headers or behaviors.

​

Default Behavior: What Happens if No OrderIndex Is Set?

If you do not specify an OrderIndex for your Edge Rules:

• Rules will execute in the order they were created.

Because of this, we strongly recommend setting an explicit OrderIndex for all rules to ensure predictable and consistent execution order.

​

Short-Circuiting vs. Multi-Action Execution

Edge rules process actions differently depending on the action type. Some actions follow a short-circuiting model, where only the first matching action of that type is executed, and further actions of that same type are ignored. This behavior applies when executing multiple actions of the same kind would cause conflicts or unintended side effects. Other actions support multi-action execution, meaning all matching actions of that type are processed, in sequence. This is typical for additive behaviors like setting response headers or appending cookies, where multiple values can coexist. We will add either the 🛑(short-circuiting model) or 🔁(multi-action execution) icon to the action list below to indicate how each action is processed.

​

Example Behaviors

If multiple rules modify the same request or response header, all matching actions will be executed, allowing cumulative changes. If multiple rules attempt to rewrite the URL or redirect, only the first matching action is executed, and subsequent conflicting actions are skipped. Example: If a request matches both conditions:

• The Cache-Control value will be 3600, because Override Browser Cache Time is a 🛑 short-circuiting action and the first match (OrderIndex = 1) wins.
• Both SetResponseHeader actions will execute, resulting in hello and hello2 headers being added.

​

Edge Rule Execution Layers (Cache vs Origin)

Edge Rules execute in two distinct stages of the request lifecycle:

• Cache Layer - evaluated on every request, before cache lookup and cache decision are finalized
• Proxy (Origin) Layer - evaluated only if the request goes to origin (CACHE MISS or BYPASS)

​

Request Flow Overview

A request is processed in the following order:

1. Edge Rules (Cache Layer)
2. Cache Lookup (HIT or MISS)
3. Edge Rules (Proxy/Origin Layer, only on MISS/BYPASS)
4. Origin Request (if needed)

​

Cache Layer Execution (Always Runs):

The following Edge Rules are evaluated at the Cache Layer, meaning they run on every request before cache resolution, regardless of whether the final result is a HIT or MISS.

• ForceSSL (Enum Value: 0) 🛑
• Redirect (Enum Value: 1) 🛑
• OverrideCacheTime (Enum Value: 3) 🛑 Note: if set to0 it will bypass edge cache, if we don’t already have the content cached on our edge.
• BlockRequest (Enum Value: 4) 🛑
• SetResponseHeader (Enum Value: 5) 🔁
• ForceDownload (Enum Value: 7) 🛑
• DisableTokenAuthentication (Enum Value: 8) 🛑
• EnableTokenAuthentication ( Enum Value: 9) 🛑
• OverrideCacheTimePublic (Enum Value: 10) 🛑
• IgnoreQueryString (Enum Value: 11) 🛑
• DisableOptimizer (Enum Value: 12) 🛑
• ForceCompression (Enum Value: 13) 🛑
• SetStatusCode (Enum Value: 14) 🛑
• OverrideBrowserCacheTime (Enum Value: 16) 🛑
• SetNetworkRateLimit (Enum Value: 18) 🛑
• SetConnectionLimit (Enum Value: 19) 🛑
• SetRequestsPerSecondLimit (Enum Value: 20) 🛑
• OverrideBrowserCacheResponseHeader (Enum Value: 25) 🛑
• RemoveBrowserCacheResponseHeader (Enum Value: 26) 🛑
• DisableShieldChallenge (Enum Value: 27) 🛑

​

Proxy (Origin) Layer Execution (MISS/BYPASS Only):

The following Edge Rules are evaluated only when the request reaches the origin, meaning:

• Cache MISS
• Cache BYPASS (e.g. due to rules or headers)

These rules are not executed on cache hits, as no origin request is made.

• OriginUrl (Enum Value: 2) 🛑
• OverrideCacheTime (Enum Value: 3) 🛑
• SetResponseHeader (Enum Value: 5) 🔁
• SetRequestHeader (Enum Value: 6) 🔁
• BypassPermaCache (Enum Value: 15) 🛑
• OriginStorage (Enum Value: 17) 🛑
• RunEdgeScript (Enum Value: 21) 🛑
• OriginMagicContainers (Enum Value: 22) 🛑
• DisableWAF (Enum Value: 23) 🛑
• RetryOrigin (Enum Value: 24) 🛑
• DisableShieldChallenge (Enum Value: 27) 🛑
• DisableShieldBotDetection (Enum Value: 29) 🛑
• BypassAwsS3Authentication (Enum Value: 30) 🛑

​

Setting the Execution Order

​

Method 1: Dashboard (Drag & Drop)

You can reorder your Edge Rules visually:

1. Go to your Pull Zone > Edge Rules tab.
2. Click “Reorder” badge at the top of the page.
3. Drag rules to change their order.
4. The order you set will automatically adjust the OrderIndex behind the scenes.

​

Method 2: API (Set OrderIndex Directly)

If you manage rules programmatically via our API, you can set the execution order by adjusting the OrderIndex value when creating or updating an edge rule.

​

Best Practices

• Plan rule priorities carefully, especially when multiple rules affect the same property or header.
• Keep related rules grouped and ordered for easier maintenance.
• Use the dashboard for visual management and the API for bulk or automated updates.