Function

isusernametaken( username )

Verifies whether a user account with the specified username is already present.

See also: Create a New User, Add User Smart Service

Parameters

Keyword	Type	Description
username	Text	The username to check against the current list of active and deactivated users.

Usage considerations

Returns a value of type Boolean.

A false result indicates that the username is available to use when creating a new user, unless the username contains special characters that are not permitted.

Both active and deactivated user accounts are referenced.

The username parameter is case-sensitive, however you will not be able to create a username if case-insensitive matches exist.

isusernametaken() cannot be used to define a column of process report data or in a process event.

Examples

You can copy and paste these examples into the Expression Rule Designer to see how this works.

isusernametaken("john.doe") returns true

Feature compatibility

The table below lists this function's compatibility with various features in Appian.

Feature	Compatibility	Note
Portals	Partially compatible	Can be used with Appian Portals if it is connected using an integration and web API.
Offline Mobile	Partially compatible	Can be used with offline mobile if it is loaded at the top of the form.
Custom Record Field Expressions	Incompatible
Process Reports	Compatible
Process Events	Compatible