New array and map operation functions in Rulesets
Cloudflare Rulesets now includes four new functions (split, join, has_key, has_value) for advanced expression logic on arrays and maps, enabling use cases like country-based blocking with custom headers.
New functions for array and map operations
Cloudflare Rulesets now include new functions that enable advanced expression logic for evaluating arrays and maps. These functions allow you to build rules that match against lists of values in request or response headers, enabling use cases like country-based blocking using custom headers.
New functions
| Function | Description |
|---|---|
split(source, delimiter) |
Splits a string into an array of strings using the specified delimiter. |
join(array, delimiter) |
Joins an array of strings into a single string using the specified delimiter. |
has_key(map, key) |
Returns true if the specified key exists in the map. |
has_value(map, value) |
Returns true if the specified value exists in the map. |
Example use cases
Check if a country code exists in a header list:
has_value(split(http.response.headers["x-allow-country"][0], ","), ip.src.country)
Check if a specific header key exists:
has_key(http.request.headers, "x-custom-header")
Join array values for logging or comparison:
join(http.request.headers.names, ", ")
For more information, refer to the Functions reference.
Source: original entry ↗
More from Cloudflare
Follow Cloudflare to get its new changes in your feed and email digest.
Cloudflare One Client for macOS 2026.8.2100.0
GA release for macOS Cloudflare One Client with improved split tunnel handling that no longer briefly blocks traffic during reconnects, support for non-RFC 1918 local IPv4 networks, faster connects with lower memory use, and numerous reliability fixes across DNS, reauthentication, and client stability.
Cloudflare One Client for Windows 2026.8.2100.0
This GA release improves split tunnel reliability, adds support for non-RFC 1918 local networks, optimizes connection performance with faster reconnections and lower memory usage, and includes numerous bug fixes for DNS, registration, and network handling. The client now features a service recovery mechanism that automatically restarts on system unlock and better handles large hosts files without blocking traffic.
Cloudflare One Client for Linux 2026.8.2100.0
New GA release for Linux with improved split tunnel handling that no longer briefly blocks traffic during reconnects, support for non-RFC 1918 local IPv4 networks, faster tunnel reconnections, and lower memory usage. Includes numerous stability and reliability fixes for DNS, reconnection behavior, and crash issues.