---
updatedAt: 2026-10-28T18:42:50.000Z
agentTools:
  siteIndex: https://techdocs.akamai.com/llms.txt
  projectIndex: https://techdocs.akamai.com/property-mgr/llms.txt
---

# matchVariable

<ul>
<li><strong>Property Manager name</strong>: <a href="doc:var">Variable</a></li>

<li><strong>Criteria version</strong>: The <code>v2026-07-21</code> rule format supports the <code>matchVariable</code> criteria v1.2.</li>

<li><strong>Rule format status</strong>: <a href="ref:api-versioning">Deprecated, outdated rule format</a></li>

<li><strong>Access</strong>: <a href="ref:advanced-and-locked-features">Read/Write</a></li>

<li><strong>Allowed in includes</strong>: <a href="ref:includes">Yes</a></li>
</ul><hr />

<p>Matches a built-in variable, or a custom variable pre-declared within the rule tree by the <a href="ref:deprecated-set-variable"><code>set​Variable</code></a> behavior.  See <a href="ref:variables">Support for variables</a> for more information on this feature.</p>

<table class="xdep">
<thead class="xdep">
<tr class="row_head">
<th>Option</th>
<th>Type</th>
<th>Description</th>
<th><a href="ref:deprecated-behaviors#object-requirements">Requires</a></th>
</tr>
</thead>
<tbody class="xdep">
<tr class="row_option variableName" id="variable-name" >
<td class><code>variable​Name</code></td>
<td>string (<a href="ref:variables">variable name</a>)</td>
<td><p>The name of the variable to match.</p></td>
<td></td>
<th><pre class="input">{"displayType":"string","tag":"input","type":"text"}</pre><pre class="visible"></pre></th></tr>
<tr class="row_option matchOperator" id="match-operator" >
<td class><code>match​Operator</code></td>
<td>enum </td>
<td><p>The type of match, based on which you use different options to specify the match criteria.</p></td>
<td></td>
<th><pre class="input">{"displayType":"enum","options":["IS","IS_NOT","IS_ONE_OF","IS_NOT_ONE_OF","IS_EMPTY","IS_NOT_EMPTY","IS_BETWEEN","IS_NOT_BETWEEN","IS_GREATER_THAN","IS_GREATER_THAN_OR_EQUAL_TO","IS_LESS_THAN","IS_LESS_THAN_OR_EQUAL_TO"],"tag":"select"}</pre><pre class="visible"></pre></th></tr>
<tr class="row_enum matchOperator">
<td></td>
<td><code>IS</code></td>
<td><p>Matches the <code>variable​Expression</code> string.</p></td>
<td></td>
</tr>
<tr class="row_enum matchOperator">
<td></td>
<td><code>IS_​NOT</code></td>
<td><p>Does not match the <code>variable​Expression</code> string.</p></td>
<td></td>
</tr>
<tr class="row_enum matchOperator">
<td></td>
<td><code>IS_​ONE_​OF</code></td>
<td><p>Matches any of an array of string <code>variable​Values</code>.</p></td>
<td></td>
</tr>
<tr class="row_enum matchOperator">
<td></td>
<td><code>IS_​NOT_​ONE_​OF</code></td>
<td><p>Does not match any of an array of string <code>variable​Values</code>.</p></td>
<td></td>
</tr>
<tr class="row_enum matchOperator">
<td></td>
<td><code>IS_​EMPTY</code></td>
<td><p>Matches if a defined variable does not contain a value. You can't activate a rule that matches an undefined variable.</p></td>
<td></td>
</tr>
<tr class="row_enum matchOperator">
<td></td>
<td><code>IS_​NOT_​EMPTY</code></td>
<td><p>Matches if a defined variable contains a value. You can't activate a rule that matches an undefined variable.</p></td>
<td></td>
</tr>
<tr class="row_enum matchOperator">
<td></td>
<td><code>IS_​BETWEEN</code></td>
<td><p>Is between the numeric <code>lower​Bound</code> and <code>upper​Bound</code> values.</p></td>
<td></td>
</tr>
<tr class="row_enum matchOperator">
<td></td>
<td><code>IS_​NOT_​BETWEEN</code></td>
<td><p>Is outside the numeric <code>lower​Bound</code> and <code>upper​Bound</code> range.</p></td>
<td></td>
</tr>
<tr class="row_enum matchOperator">
<td></td>
<td><code>IS_​GREATER_​THAN</code></td>
<td><p>Is greater than the <code>variable​Expression</code> string-formatted number.</p></td>
<td></td>
</tr>
<tr class="row_enum matchOperator">
<td></td>
<td><code>IS_​GREATER_​THAN_​OR_​EQUAL_​TO</code></td>
<td><p>Is greater than or equal to the <code>variable​Expression</code> string-formatted number.</p></td>
<td></td>
</tr>
<tr class="row_enum matchOperator">
<td></td>
<td><code>IS_​LESS_​THAN</code></td>
<td><p>Is less than the <code>variable​Expression</code> string-formatted number.</p></td>
<td></td>
</tr>
<tr class="row_enum matchOperator">
<td></td>
<td><code>IS_​LESS_​THAN_​OR_​EQUAL_​TO</code></td>
<td><p>Is less than or equal to the <code>variable​Expression</code> string-formatted number.</p></td>
<td></td>
</tr>
<tr class="row_option variableValues" id="variable-values" data-visible='{"if":{"attribute":"matchOperator","op":"in","value":["IS_ONE_OF","IS_NOT_ONE_OF"]}}'>
<td class><code>variable​Values</code></td>
<td>string array </td>
<td><p>Specifies an array of matching strings.</p></td>
<td><code>match​Operator</code> is either: <code>IS_​ONE_​OF</code>, <code>IS_​NOT_​ONE_​OF</code></td>
<th><pre class="input">{"displayType":"string array","tag":"input","todo":true}</pre><pre class="visible">{"if":{"attribute":"matchOperator","op":"in","value":["IS_ONE_OF","IS_NOT_ONE_OF"]}}</pre></th></tr>
<tr class="row_option variableExpression" id="variable-expression" data-visible='{"if":{"attribute":"matchOperator","op":"in","value":["IS","IS_NOT","IS_GREATER_THAN","IS_GREATER_THAN_OR_EQUAL_TO","IS_LESS_THAN","IS_LESS_THAN_OR_EQUAL_TO"]}}'>
<td class><code>variable​Expression</code></td>
<td>string (allows&nbsp;<a href="ref:variables">variables</a>)</td>
<td><p>Specifies a single matching string.</p></td>
<td><code>match​Operator</code> is either: <code>IS</code>, <code>IS_​NOT</code>, <code>IS_​GREATER_​THAN</code>, <code>IS_​GREATER_​THAN_​OR_​EQUAL_​TO</code>, <code>IS_​LESS_​THAN</code>, <code>IS_​LESS_​THAN_​OR_​EQUAL_​TO</code></td>
<th><pre class="input">{"displayType":"string","tag":"input","type":"text"}</pre><pre class="visible">{"if":{"attribute":"matchOperator","op":"in","value":["IS","IS_NOT","IS_GREATER_THAN","IS_GREATER_THAN_OR_EQUAL_TO","IS_LESS_THAN","IS_LESS_THAN_OR_EQUAL_TO"]}}</pre></th></tr>
<tr class="row_option lowerBound" id="lower-bound" data-visible='{"if":{"attribute":"matchOperator","op":"in","value":["IS_BETWEEN","IS_NOT_BETWEEN"]}}'>
<td class><code>lower​Bound</code></td>
<td>string </td>
<td><p>Specifies the range's numeric minimum value.</p></td>
<td><code>match​Operator</code> is either: <code>IS_​BETWEEN</code>, <code>IS_​NOT_​BETWEEN</code></td>
<th><pre class="input">{"displayType":"string","tag":"input","type":"text"}</pre><pre class="visible">{"if":{"attribute":"matchOperator","op":"in","value":["IS_BETWEEN","IS_NOT_BETWEEN"]}}</pre></th></tr>
<tr class="row_option upperBound" id="upper-bound" data-visible='{"if":{"attribute":"matchOperator","op":"in","value":["IS_BETWEEN","IS_NOT_BETWEEN"]}}'>
<td class><code>upper​Bound</code></td>
<td>string </td>
<td><p>Specifies the range's numeric maximum value.</p></td>
<td><code>match​Operator</code> is either: <code>IS_​BETWEEN</code>, <code>IS_​NOT_​BETWEEN</code></td>
<th><pre class="input">{"displayType":"string","tag":"input","type":"text"}</pre><pre class="visible">{"if":{"attribute":"matchOperator","op":"in","value":["IS_BETWEEN","IS_NOT_BETWEEN"]}}</pre></th></tr>
<tr class="row_option matchWildcard" id="match-wildcard" data-visible='{"if":{"attribute":"matchOperator","op":"in","value":["IS","IS_NOT","IS_ONE_OF","IS_NOT_ONE_OF"]}}'>
<td class><code>match​Wildcard</code></td>
<td>boolean </td>
<td><p>When matching string expressions, enabling this allows wildcards, where <code>?</code> matches a single character and <code>*</code> matches zero or more characters.</p></td>
<td><code>match​Operator</code> is either: <code>IS</code>, <code>IS_​NOT</code>, <code>IS_​ONE_​OF</code>, <code>IS_​NOT_​ONE_​OF</code></td>
<th><pre class="input">{"displayType":"boolean","tag":"input","type":"checkbox"}</pre><pre class="visible">{"if":{"attribute":"matchOperator","op":"in","value":["IS","IS_NOT","IS_ONE_OF","IS_NOT_ONE_OF"]}}</pre></th></tr>
<tr class="row_option matchCaseSensitive" id="match-case-sensitive" data-visible='{"if":{"attribute":"matchOperator","op":"in","value":["IS","IS_NOT","IS_ONE_OF","IS_NOT_ONE_OF"]}}'>
<td class><code>match​Case​Sensitive</code></td>
<td>boolean </td>
<td><p>When matching string expressions, enabling this performs a case-sensitive match.</p></td>
<td><code>match​Operator</code> is either: <code>IS</code>, <code>IS_​NOT</code>, <code>IS_​ONE_​OF</code>, <code>IS_​NOT_​ONE_​OF</code></td>
<th><pre class="input">{"displayType":"boolean","tag":"input","type":"checkbox"}</pre><pre class="visible">{"if":{"attribute":"matchOperator","op":"in","value":["IS","IS_NOT","IS_ONE_OF","IS_NOT_ONE_OF"]}}</pre></th></tr>
</tbody>
</table>

# Sibling pages

* [advancedImMatch](https://techdocs.akamai.com/property-mgr/reference/deprecated-advanced-im-match.md)
* [bucket](https://techdocs.akamai.com/property-mgr/reference/deprecated-bucket.md)
* [cacheability](https://techdocs.akamai.com/property-mgr/reference/deprecated-cacheability.md)
* [chinaCdnRegion](https://techdocs.akamai.com/property-mgr/reference/deprecated-china-cdn-region.md)
* [clientCertificate](https://techdocs.akamai.com/property-mgr/reference/deprecated-client-certificate.md)
* [clientIp](https://techdocs.akamai.com/property-mgr/reference/deprecated-client-ip.md)
* [clientIpVersion](https://techdocs.akamai.com/property-mgr/reference/deprecated-client-ip-version.md)
* [cloudletsOrigin](https://techdocs.akamai.com/property-mgr/reference/deprecated-cloudlets-origin.md)
* [contentDeliveryNetwork](https://techdocs.akamai.com/property-mgr/reference/deprecated-content-delivery-network.md)
* [contentType](https://techdocs.akamai.com/property-mgr/reference/deprecated-content-type.md)
* [debugMode](https://techdocs.akamai.com/property-mgr/reference/deprecated-debug-mode.md)
* [deviceCharacteristic](https://techdocs.akamai.com/property-mgr/reference/deprecated-device-characteristic.md)
* [fileExtension](https://techdocs.akamai.com/property-mgr/reference/deprecated-file-extension.md)
* [edgeWorkersFailure](https://techdocs.akamai.com/property-mgr/reference/deprecated-edge-workers-failure.md)
* [filename](https://techdocs.akamai.com/property-mgr/reference/deprecated-filename.md)
* [hostname](https://techdocs.akamai.com/property-mgr/reference/deprecated-hostname.md)
* [matchAdvanced](https://techdocs.akamai.com/property-mgr/reference/deprecated-match-advanced.md)
* [matchCpCode](https://techdocs.akamai.com/property-mgr/reference/deprecated-match-cp-code.md)
* [matchResponseCode](https://techdocs.akamai.com/property-mgr/reference/deprecated-match-response-code.md)
* [metadataStage](https://techdocs.akamai.com/property-mgr/reference/deprecated-metadata-stage.md)
* [originTimeout](https://techdocs.akamai.com/property-mgr/reference/deprecated-origin-timeout.md)
* [path](https://techdocs.akamai.com/property-mgr/reference/deprecated-path.md)
* [queryStringParameter](https://techdocs.akamai.com/property-mgr/reference/deprecated-query-string-parameter.md)
* [random](https://techdocs.akamai.com/property-mgr/reference/deprecated-random.md)
* [recoveryConfig](https://techdocs.akamai.com/property-mgr/reference/deprecated-recovery-config.md)
* [regularExpression](https://techdocs.akamai.com/property-mgr/reference/deprecated-regular-expression.md)
* [requestCookie](https://techdocs.akamai.com/property-mgr/reference/deprecated-request-cookie.md)
* [requestHeader](https://techdocs.akamai.com/property-mgr/reference/deprecated-request-header.md)
* [requestMethod](https://techdocs.akamai.com/property-mgr/reference/deprecated-request-method.md)
* [requestProtocol](https://techdocs.akamai.com/property-mgr/reference/deprecated-request-protocol.md)
* [requestType](https://techdocs.akamai.com/property-mgr/reference/deprecated-request-type.md)
* [responseHeader](https://techdocs.akamai.com/property-mgr/reference/deprecated-response-header.md)
* [serverLocation](https://techdocs.akamai.com/property-mgr/reference/deprecated-server-location.md)
* [userNetwork](https://techdocs.akamai.com/property-mgr/reference/deprecated-user-network.md)
* [time](https://techdocs.akamai.com/property-mgr/reference/deprecated-time.md)
* [tokenAuthorization](https://techdocs.akamai.com/property-mgr/reference/deprecated-token-authorization.md)
* [userAgent](https://techdocs.akamai.com/property-mgr/reference/deprecated-user-agent.md)
* [userLocation](https://techdocs.akamai.com/property-mgr/reference/deprecated-user-location.md)
* [variableError](https://techdocs.akamai.com/property-mgr/reference/deprecated-variable-error.md)