Free cookie consent management tool by TermsFeed toemailaddress() Function
toemailaddress() Function


toemailaddress( value )

Converts a value to email address.

See also: Send E-Mail Smart Service


Keyword Type Description


Any Type

Value to convert.


Email Address

Usage considerations

Using toemailaddress() with arrays

When operating on arrays, it is not necessary to use apply with toemailaddress. If multiple parameters are passed, or one parameter is an Array, toemailaddress will return an Email Address Array.

Understanding results

Can convert an email address Text.

The output can be converted to a value with an Email Recipient type for use in the To:, Cc:, or Bcc: field in the Setup tab of the Send E-Mail Smart Service.


toemailaddress("") returns as an Email Address type.

toemailaddress("","") and toemailaddress({"",""}) both return {,} as a List of Email Address type.

Feature compatibility

The table below lists this function's compatibility with various features in Appian.
Feature Compatibility Note
Portals Compatible
Offline Mobile Compatible
Sync-Time Custom Record Fields Compatible

Can be used to create a custom record field that only evaluates at sync time.

Real-Time Custom Record Fields Incompatible

Custom record fields that evaluate in real time must be configured using one or more Custom Field functions.

Process Reports Compatible
Process Events Compatible

toemailaddress() Function