Whatever message this page gives is out now! Go check it out!

IsUserInAnyRole

Last update:
May 18, 2026

Description

Determines whether an authenticated user belongs to any role in a list of roles.

Returns

True, if the authenticated user, belongs to any Role in the list; False, otherwise.

Category

IsUserInAnyRole(role_list)

See also

cflogincfloginusercflogoutGetAuthUserGetUserRolesIsUserInRoleIsUserLoggedInSecuring Applications in the Developing ColdFusion Applications

History

ColdFusion 8: Added this function.

Parameters

Parameter
Description
role_list
A comma-delimited list of one or more roles to be tested.

Example

 
<cfif IsUserInAnyRole(allRoles) > 
<cfoutput>Authenticated user is in these roles: #GetUserRoles()#</cfoutput> 
<cfelseif > 
<cfoutput>Authenticated user is in no roles</cfoutput> 
</cfif>
Note:
From ColdFusion 11 onwards, this function is not applicable when a user is logged in using Admin API.

Share this page

Was this page helpful?
We're glad. Tell us how this page helped.
We're sorry. Can you tell us what didn't work for you?
Thank you for your feedback. Your response will help improve this page.

On this page