GlideUser - Scoped

concept australia Updated Sep 10, 2026 3 min read c_GlideUserScopedAPI.md
Raw file servicenow.com

The GlideUser API provides methods to access information about the current user and current user roles.

Using the GlideUser API avoids the need to use the slower GlideRecord queries to get user information.

Parent Topic:Server API reference

Scoped GlideUser - getCompanyID()

Returns the current user's company sys_id.

Name Type Description
None
Type Description
String Company sys_id.
JavaScript
var currentUser = gs.getUser(); gs.info(currentUser.getCompanyID());

Scoped GlideUser - getDisplayName()

Returns the current user's display name.

Name Type Description
None
Type Description
String User's display name
JavaScript
var currentUser = gs.getUser(); gs.info(currentUser.getDisplayName());

Scoped GlideUser - getEmail()

Returns the user's email address.

Name Type Description
None
Type Description
String User's email address.
JavaScript
var currentUser = gs.getUser(); gs.info(currentUser.getEmail());

Scoped GlideUser - getFirstName()

Returns the user's first name.

Name Type Description
None
Type Description
String User's first name.
JavaScript
var currentUser = gs.getUser(); gs.info(currentUser.getFirstName());

Scoped GlideUser - getID()

Gets the sys_id of the current user.

Name Type Description
None
Type Description
String User's sys_id.
JavaScript
var currentUser = gs.getUser(); gs.info(currentUser.getID());

Scoped GlideUser - getLastName()

Returns the user's last name.

Name Type Description
None
Type Description
String User's last name.
JavaScript
var currentUser = gs.getUser(); gs.info(currentUser.getLastName());

Scoped GlideUser - getName()

Returns the user ID, or login name, of the current user.

Name Type Description
None
Type Description
String User ID or login name.
JavaScript
var currentUser = gs.getUser(); gs.info(currentUser.getName());

Scoped GlideUser - getPreference(String name)

Gets the specified user preference value for the current user.

Name Type Description
name String Name of the preference.
Type Description
String Preference value.
JavaScript
var currentUser = gs.getUser(); currentUser.savePreference(­'myPref','red'); gs.info(currentUser.getPreference(­'myPref'));

Scoped GlideUser - getRoles()

Returns a list of roles that includes explicitly granted roles, inherited roles, and roles acquired by group membership.

Name Type Description
None
Type Description
Array List of all roles available to the user
JavaScript
var currentUser = gs.getUser(); gs.info(currentUser.getRoles());

Scoped GlideUser - getTimeZoneLabel()

Returns the current user's time zone label in the current user's preferred language.

For more information about setting a user's preferred language, see User specific language.

Name Type Description
None
Type Description
String The current user's time zone label.

This example shows how to return the current user's time zone label in their preferred language.

JavaScript
gs.info(gs.getUser().getTimeZoneLabel());

Output:

Text
Europe/Dublin

Scoped GlideUser - getTimeZoneLabelLang(String language)

Returns the current user's time zone label in the specified language.

Name

Type

Description

language

String

Language to use for the time zone label. Located in the ID column of the Language [sys_language] table. If a valid language isn't provided, the time zone label is returned in English.

|Type|Description| |----|-----------| |String|The current user's time zone label.|

This example shows how to return the current user's time zone label in a specified language.

JavaScript
gs.info(gs.getUser().getTimeZoneLabelLang("es")); //Spanishgs.info(gs.getUser().getTimeZoneLabelLang("ja")); //Japanesegs.info(gs.getUser().getTimeZoneLabelLang("jksjsjks")); //invalid

Output:

Text
Europa/Dublínヨーロッパ/ダブリンEurope/Dublin

Scoped GlideUser - getUserRoles()

Returns the list of roles explicitly granted to the user.

Unlike the getRoles() method, this method does not return roles the user inherits or roles acquired from group membership.

Name Type Description
None
Type Description
Array List of roles explicitly assigned to the user.
JavaScript
var currentUser = gs.getUser(); gs.info(currentUser.getUserRoles());

Scoped GlideUser - hasRole(String role)

Determines if the current user has the specified role.

Name Type Description
role String Role to check.

Type

Description

Boolean

Flag that indicates whether the user has the specified role.Possible values:

  • true: User has the specified role.
  • false: User doesn't have the specified role.
``` var currentUser = gs.getUser(); gs.info(currentUser.hasRole('admin')); ```

Scoped GlideUser - isMemberOf(String group)

Determines if the current user is a member of the specified group.

Name Type Description
group String Sys_id or name of the group to check.

Type

Description

Boolean

Flag that indicates whether the user is a member of the specified group.Possible values:

  • true: User is a member of the group.
  • false: User isn't a member of the group.
The following example checks if the current user is a member of the Capacity Mgmt group.
JavaScript
var currentUser = gs.getUser(); gs.info(currentUser.isMemberOf('Capacity Mgmt'));

Output:

Text
false

Scoped GlideUser - savePreference(String name, String value)

Saves a user preference value to the database.

Name Type Description
name String Preference to save.
value String Preference value.
Type Description
None
JavaScript
var currentUser = gs.getUser(); currentUser.savePreference('myPref','red'); gs.info(currentUser.getPreference('myPref'));
Search documentation
Search document titles and file paths on the australia branch