---
schema_version: "1"
id: 0e0a5d5b73ee633a5565a0ea3f925cf53b296186124195f6cc5cf1df2c52e124
title: Validation Module Documentation Reference
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/validation-connector/1.4/validation-documentation.md
canonical_url: https://docs.mulesoft.com/validation-connector/1.4/validation-documentation
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 2c05387b2bd1d1f7072d583ff25e519722202f92abd737231ef5ca7e03ff6f8b
description: MuleSoft Documentation Site
release: "1.4"
latest: false
---
---
product: Validation Module
version: 1.4
---

# Validation Module Documentation Reference

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

Validation Module v1.4

The Validation module can verify that the contents of a message in a Mule flow match specific
criteria. The module provides explicit messages about the cause of an exception in a flow. Based on
the specific data you are validating, you can customize the exception message that is displayed in
the logs.

A module that performs data validations. If the validation fails, an Error is thrown. The error type
might vary but it will always be a child of VALIDATION:VALIDATION.

If a message does not meet the defined validation criteria, the validation fails and returns a
`VALIDATION` error (such as `VALIDATION:INVALID_URL`), which is a `ValidationException`. By default,
this message includes a meaningful message that you can customize.

Release Notes: [Validation Module Release Notes](https://docs.mulesoft.com/release-notes/mule-runtime/module-validation)

## Configurations

---

### Default Configuration

Default configuration

#### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Name</p></td><td><p>String</p></td><td><p>The name for this configuration. Connectors reference the configuration with this name.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>I18n</p></td><td><div><div><p><a href="#i18n">I18n</a></p></div></div></td><td><p>Allows to configure I18n for the standard error messages</p></td><td></td><td></td></tr><tr><td><p>Expiration Policy</p></td><td><div><div><p><a href="#ExpirationPolicy">Expiration Policy</a></p></div></div></td><td><p>Configures the minimum amount of time that a dynamic configuration instance can remain idle before the runtime considers it eligible for expiration. This does not mean that the platform will expire the instance at the exact moment that it becomes eligible. The runtime actually purge the instances as it sees fit.</p></td><td></td><td></td></tr></tbody></table>

## Operations

- [Is Blank String](#isBlankString)

- [Is Elapsed](#isElapsed)

- [Is Email](#isEmail)

- [Is Empty Collection](#isEmptyCollection)

- [Is False](#isFalse)

- [Is IP](#isIp)

- [Is Not Blacklisted Ip](#isNotBlacklistedIp)

- [Is Not Blank String](#isNotBlankString)

- [Is Not Elapsed](#isNotElapsed)

- [Is Not Empty Collection](#isNotEmptyCollection)

- [Is Not Null](#isNotNull)

- [Is Null](#isNull)

- [Is Number](#isNumber)

- [Is Time](#isTime)

- [Is True](#isTrue)

- [Is URL](#isUrl)

- [Is Whitelisted Ip](#isWhitelistedIp)

- [Matches Regex](#matchesRegex)

- [Validate Size](#validateSize)

### Is Blank String

`<validation:is-blank-string>`

Validates that value is a blank String.

#### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Value</p></td><td><div><div><p>String</p></div></div></td><td><p>the value to check</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Message</p></td><td><div><div><p>String</p></div></div></td><td><p>Specifies the message that is to be notified to the user if the validation fails. It’s marked as not dynamic to allow eager evaluation of the expression in case that the validation is successful and the message is not needed. Components consuming this value are to manually check if this is an expression and evaluate it in case that the validation failed</p></td><td></td><td></td></tr></tbody></table>

#### For Configurations.

- [Default Configuration](#config)

#### Throws

- VALIDATION:NOT\_BLANK\_STRING

### Is Elapsed

`<validation:is-elapsed>`

Validates the amount of time that has elapsed since the moment in the since parameter is greater
than an specified amount of time.

#### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Time</p></td><td><div><div><p>Number</p></div></div></td><td><p>the interval size</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Time Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>the interval unit (as a TimeUnit)</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Since</p></td><td><div><div><p>DateTime</p></div></div></td><td><p>the time to validate</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Message</p></td><td><div><div><p>String</p></div></div></td><td><p>Specifies the message that is to be notified to the user if the validation fails. It’s marked as not dynamic to allow eager evaluation of the expression in case that the validation is successful and the message is not needed. Components consuming this value are to manually check if this is an expression and evaluate it in case that the validation failed</p></td><td></td><td></td></tr></tbody></table>

#### For Configurations.

- [Default Configuration](#config)

#### Throws

- VALIDATION:NOT\_ELAPSED\_TIME

### Is Email

`<validation:is-email>`

Validates that the email address is valid

#### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Email</p></td><td><div><div><p>String</p></div></div></td><td><p>an email address</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Message</p></td><td><div><div><p>String</p></div></div></td><td><p>Specifies the message that is to be notified to the user if the validation fails. It’s marked as not dynamic to allow eager evaluation of the expression in case that the validation is successful and the message is not needed. Components consuming this value are to manually check if this is an expression and evaluate it in case that the validation failed</p></td><td></td><td></td></tr></tbody></table>

#### For Configurations.

- [Default Configuration](#config)

#### Throws

- VALIDATION:INVALID\_EMAIL

### Is Empty Collection

`<validation:is-empty-collection>`

Validates that value is an empty collection.

#### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Values</p></td><td><div><div><p>Array of Any</p></div></div></td><td><p>the value to check</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Message</p></td><td><div><div><p>String</p></div></div></td><td><p>Specifies the message that is to be notified to the user if the validation fails. It’s marked as not dynamic to allow eager evaluation of the expression in case that the validation is successful and the message is not needed. Components consuming this value are to manually check if this is an expression and evaluate it in case that the validation failed</p></td><td></td><td></td></tr></tbody></table>

#### For Configurations.

- [Default Configuration](#config)

#### Throws

- VALIDATION:NOT\_EMPTY\_COLLECTION

### Is False

`<validation:is-false>`

Validates that the given value is false

#### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Expression</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>the boolean to test</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Message</p></td><td><div><div><p>String</p></div></div></td><td><p>Specifies the message that is to be notified to the user if the validation fails. It’s marked as not dynamic to allow eager evaluation of the expression in case that the validation is successful and the message is not needed. Components consuming this value are to manually check if this is an expression and evaluate it in case that the validation failed</p></td><td></td><td></td></tr></tbody></table>

#### For Configurations.

- [Default Configuration](#config)

#### Throws

- VALIDATION:INVALID\_BOOLEAN

### Is IP

`<validation:is-ip>`

Validates that an ip address represented as a String is valid

#### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Ip</p></td><td><div><div><p>String</p></div></div></td><td><p>the ip address to validate</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Message</p></td><td><div><div><p>String</p></div></div></td><td><p>Specifies the message that is to be notified to the user if the validation fails. It’s marked as not dynamic to allow eager evaluation of the expression in case that the validation is successful and the message is not needed. Components consuming this value are to manually check if this is an expression and evaluate it in case that the validation failed</p></td><td></td><td></td></tr></tbody></table>

#### For Configurations.

- [Default Configuration](#config)

#### Throws

- VALIDATION:INVALID\_IP

### Is Not Blacklisted Ip

`<validation:is-not-blacklisted-ip>`

Validates that a ipAddress is not present in the ipList.

#### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Ip Address</p></td><td><div><div><p>String</p></div></div></td><td><p>the address to validate</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Black List</p></td><td><div><div><p><a href="#IpFilterList">IP Filter List</a></p></div></div></td><td><p>the list of disallowed addresses</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Message</p></td><td><div><div><p>String</p></div></div></td><td><p>Specifies the message that is to be notified to the user if the validation fails. It’s marked as not dynamic to allow eager evaluation of the expression in case that the validation is successful and the message is not needed. Components consuming this value are to manually check if this is an expression and evaluate it in case that the validation failed</p></td><td></td><td></td></tr></tbody></table>

#### For Configurations.

- [Default Configuration](#config)

#### Throws

- VALIDATION:INVALID\_IP

- VALIDATION:REJECTED\_IP

### Is Not Blank String

`<validation:is-not-blank-string>`

Validates that value is not a blank String.

#### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Value</p></td><td><div><div><p>String</p></div></div></td><td><p>the String to check</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Message</p></td><td><div><div><p>String</p></div></div></td><td><p>Specifies the message that is to be notified to the user if the validation fails. It’s marked as not dynamic to allow eager evaluation of the expression in case that the validation is successful and the message is not needed. Components consuming this value are to manually check if this is an expression and evaluate it in case that the validation failed</p></td><td></td><td></td></tr></tbody></table>

#### For Configurations.

- [Default Configuration](#config)

#### Throws

- VALIDATION:BLANK\_STRING

### Is Not Elapsed

`<validation:is-not-elapsed>`

Validates the amount of time that has elapsed since the moment in the since parameter is greater
than an specified amount of time.

#### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Time</p></td><td><div><div><p>Number</p></div></div></td><td><p>the interval size</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Time Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>the interval unit (as a TimeUnit)</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Since</p></td><td><div><div><p>DateTime</p></div></div></td><td><p>the time to validate</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Message</p></td><td><div><div><p>String</p></div></div></td><td><p>Specifies the message that is to be notified to the user if the validation fails. It’s marked as not dynamic to allow eager evaluation of the expression in case that the validation is successful and the message is not needed. Components consuming this value are to manually check if this is an expression and evaluate it in case that the validation failed</p></td><td></td><td></td></tr></tbody></table>

#### For Configurations.

- [Default Configuration](#config)

#### Throws

- VALIDATION:ELAPSED\_TIME

### Is Not Empty Collection

`<validation:is-not-empty-collection>`

Validates that value is not an empty collection.

#### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Values</p></td><td><div><div><p>Array of Any</p></div></div></td><td><p>the value to check</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Message</p></td><td><div><div><p>String</p></div></div></td><td><p>Specifies the message that is to be notified to the user if the validation fails. It’s marked as not dynamic to allow eager evaluation of the expression in case that the validation is successful and the message is not needed. Components consuming this value are to manually check if this is an expression and evaluate it in case that the validation failed</p></td><td></td><td></td></tr></tbody></table>

#### For Configurations.

- [Default Configuration](#config)

#### Throws

- VALIDATION:EMPTY\_COLLECTION

### Is Not Null

`<validation:is-not-null>`

Validates that the given value is not null.

#### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Value</p></td><td><div><div><p>Any</p></div></div></td><td><p>the value to test</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Message</p></td><td><div><div><p>String</p></div></div></td><td><p>Specifies the message that is to be notified to the user if the validation fails. It’s marked as not dynamic to allow eager evaluation of the expression in case that the validation is successful and the message is not needed. Components consuming this value are to manually check if this is an expression and evaluate it in case that the validation failed</p></td><td></td><td></td></tr></tbody></table>

#### For Configurations.

- [Default Configuration](#config)

#### Throws

- VALIDATION:NULL

### Is Null

`<validation:is-null>`

Validates that the given value is null.

#### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Value</p></td><td><div><div><p>Any</p></div></div></td><td><p>the value to test</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Message</p></td><td><div><div><p>String</p></div></div></td><td><p>Specifies the message that is to be notified to the user if the validation fails. It’s marked as not dynamic to allow eager evaluation of the expression in case that the validation is successful and the message is not needed. Components consuming this value are to manually check if this is an expression and evaluate it in case that the validation failed</p></td><td></td><td></td></tr></tbody></table>

#### For Configurations.

- [Default Configuration](#config)

#### Throws

- VALIDATION:NOT\_NULL

### Is Number

`<validation:is-number>`

Receives a numeric value as a String and validates that it can be parsed per the rules of a
numberType

#### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Value</p></td><td><div><div><p>String</p></div></div></td><td><p>the value to be tested</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Locale</p></td><td><div><div><p>String</p></div></div></td><td><p>The locale to use for the format. If not provided it defaults to the system Locale</p></td><td></td><td></td></tr><tr><td><p>Pattern</p></td><td><div><div><p>String</p></div></div></td><td><p>The pattern used to format the value</p></td><td></td><td></td></tr><tr><td><p>Min Value</p></td><td><div><div><p>String</p></div></div></td><td><p>If provided, check that the parsed value is greater or equal than this value</p></td><td></td><td></td></tr><tr><td><p>Max Value</p></td><td><div><div><p>String</p></div></div></td><td><p>If provided, check that the parsed value is less or equal than this value</p></td><td></td><td></td></tr><tr><td><p>Number Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>INTEGER</p></li><li><p>LONG</p></li><li><p>SHORT</p></li><li><p>DOUBLE</p></li><li><p>FLOAT</p></li></ul></div></div></td><td><p>the type of number to test value against</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Message</p></td><td><div><div><p>String</p></div></div></td><td><p>Specifies the message that is to be notified to the user if the validation fails. It’s marked as not dynamic to allow eager evaluation of the expression in case that the validation is successful and the message is not needed. Components consuming this value are to manually check if this is an expression and evaluate it in case that the validation failed</p></td><td></td><td></td></tr></tbody></table>

#### For Configurations.

- [Default Configuration](#config)

#### Throws

- VALIDATION:INVALID\_NUMBER

### Is Time

`<validation:is-time>`

Validates that a time in String format is valid for the given pattern and locale. If no pattern is
provided, then the locale’s default will be used

#### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Time</p></td><td><div><div><p>String</p></div></div></td><td><p>A date in String format</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Locale</p></td><td><div><div><p>String</p></div></div></td><td><p>the locale of the String</p></td><td></td><td></td></tr><tr><td><p>Pattern</p></td><td><div><div><p>String</p></div></div></td><td><p>the pattern for the date</p></td><td></td><td></td></tr><tr><td><p>Message</p></td><td><div><div><p>String</p></div></div></td><td><p>Specifies the message that is to be notified to the user if the validation fails. It’s marked as not dynamic to allow eager evaluation of the expression in case that the validation is successful and the message is not needed. Components consuming this value are to manually check if this is an expression and evaluate it in case that the validation failed</p></td><td></td><td></td></tr></tbody></table>

#### For Configurations.

- [Default Configuration](#config)

#### Throws

- VALIDATION:INVALID\_TIME

### Is True

`<validation:is-true>`

Validates that the given value is true

#### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Expression</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>the boolean to test</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Message</p></td><td><div><div><p>String</p></div></div></td><td><p>Specifies the message that is to be notified to the user if the validation fails. It’s marked as not dynamic to allow eager evaluation of the expression in case that the validation is successful and the message is not needed. Components consuming this value are to manually check if this is an expression and evaluate it in case that the validation failed</p></td><td></td><td></td></tr></tbody></table>

#### For Configurations.

- [Default Configuration](#config)

#### Throws

- VALIDATION:INVALID\_BOOLEAN

### Is URL

`<validation:is-url>`

Validates that url is a valid one

#### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>URL</p></td><td><div><div><p>String</p></div></div></td><td><p>the URL to validate as a String</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Message</p></td><td><div><div><p>String</p></div></div></td><td><p>Specifies the message that is to be notified to the user if the validation fails. It’s marked as not dynamic to allow eager evaluation of the expression in case that the validation is successful and the message is not needed. Components consuming this value are to manually check if this is an expression and evaluate it in case that the validation failed</p></td><td></td><td></td></tr></tbody></table>

#### For Configurations.

- [Default Configuration](#config)

#### Throws

- VALIDATION:INVALID\_URL

### Is Whitelisted Ip

`<validation:is-whitelisted-ip>`

Validates that a ipAddress is present in the ipList.

#### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Ip Address</p></td><td><div><div><p>String</p></div></div></td><td><p>the address to validate</p></td><td></td><td><p>x</p></td></tr><tr><td><p>White List</p></td><td><div><div><p><a href="#IpFilterList">IP Filter List</a></p></div></div></td><td><p>the list of allowed addresses</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Message</p></td><td><div><div><p>String</p></div></div></td><td><p>Specifies the message that is to be notified to the user if the validation fails. It’s marked as not dynamic to allow eager evaluation of the expression in case that the validation is successful and the message is not needed. Components consuming this value are to manually check if this is an expression and evaluate it in case that the validation failed</p></td><td></td><td></td></tr></tbody></table>

#### For Configurations.

- [Default Configuration](#config)

#### Throws

- VALIDATION:INVALID\_IP

- VALIDATION:REJECTED\_IP

### Matches Regex

`<validation:matches-regex>`

Validates that value matches the regex regular expression

#### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Value</p></td><td><div><div><p>String</p></div></div></td><td><p>the value to check</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Regex</p></td><td><div><div><p>String</p></div></div></td><td><p>the regular expression to check against</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Case Sensitive</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>when true matching is case sensitive, otherwise matching is case in-sensitive</p></td><td><p>true</p></td><td></td></tr><tr><td><p>Message</p></td><td><div><div><p>String</p></div></div></td><td><p>Specifies the message that is to be notified to the user if the validation fails. It’s marked as not dynamic to allow eager evaluation of the expression in case that the validation is successful and the message is not needed. Components consuming this value are to manually check if this is an expression and evaluate it in case that the validation failed</p></td><td></td><td></td></tr></tbody></table>

#### For Configurations.

- [Default Configuration](#config)

#### Throws

- VALIDATION:MISMATCH

### Validate Size

`<validation:validate-size>`

Validates that value has a size between certain inclusive boundaries. This validator is capable of
handling instances of String, Collection, Map and arrays

#### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Value</p></td><td><div><div><p>Any</p></div></div></td><td><p>the value to validate</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Min</p></td><td><div><div><p>Number</p></div></div></td><td><p>the minimum expected length (inclusive, defaults to zero)</p></td><td><p>0</p></td><td></td></tr><tr><td><p>Max</p></td><td><div><div><p>Number</p></div></div></td><td><p>the maximum expected length (inclusive). Leave unspecified or null to allow any max length</p></td><td></td><td></td></tr><tr><td><p>Message</p></td><td><div><div><p>String</p></div></div></td><td><p>Specifies the message that is to be notified to the user if the validation fails. It’s marked as not dynamic to allow eager evaluation of the expression in case that the validation is successful and the message is not needed. Components consuming this value are to manually check if this is an expression and evaluate it in case that the validation failed</p></td><td></td><td></td></tr></tbody></table>

#### For Configurations.

- [Default Configuration](#config)

#### Throws

- VALIDATION:INVALID\_SIZE

### All

`<validation:all>`

Perform a list of nested validation operations and informs only one VALIDATION:MULTIPLE error which
summarizes all of the found errors (if any).

#### Throws

- VALIDATION:MULTIPLE

### Any

**Available since version 1.3**

`<validation:any>`

Perform a list of nested validation operations and informs one VALIDATION:MULTIPLE error which
summarizes all of the found errors if none of the inner validations were successful.

#### Throws

- VALIDATION:MULTIPLE

## Types

### I18n

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Bundle Path</p></td><td><div><div><p>String</p></div></div></td><td><p>The path to a bundle file containing the messages. If null then the platform will choose a default one</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Locale</p></td><td><div><div><p>String</p></div></div></td><td><p>The locale of the null the platform will choose the system default</p></td><td></td><td></td></tr></tbody></table>

### Expiration Policy

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Max Idle Time</p></td><td><div><div><p>Number</p></div></div></td><td><p>A scalar time value for the maximum amount of time a dynamic configuration instance should be allowed to be idle before it’s considered eligible for expiration</p></td><td></td><td></td></tr><tr><td><p>Time Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the maxIdleTime attribute</p></td><td></td><td></td></tr></tbody></table>

### IP Filter List

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Ips</p></td><td><div><div><p>Array of String</p></div></div></td><td></td><td></td><td><p>x</p></td></tr></tbody></table>

## See Also

[Salesforce Help](https://help.salesforce.com)