TWiki Variables » Search » Category: Users & Authentication

AUTHREALM -- authentication realm

• String defined as {AuthRealm} in configure. This is used in certain password encodings, and in login templates as part of the login prompt.
• Syntax: %AUTHREALM%
• Expands to: Enter your LoginName. (Typically first name and last name, no space, no dots, capitalized, such as JohnSmith). Visit TWikiRegistration if you do not have one, or login anonymously as "TWikiGuest" with password "guest".
• Category: AdministrationVariables, SecurityAndAccessControlVariables, UsersAndAuthenticationVariables
• Related: TWikiUserAuthentication, SESSIONID, SESSIONVAR, LOGIN, LOGOUT, SESSION_VARIABLE (this topic)

BUBBLESIG -- show bubble box and user signature with profile picture icon

• Syntax: %BUBBLESIG{WikiName}% or %BUBBLESIG{WikiName - YYYY-MM-DD}%
• The parameter can be either just the WikiName of a user, or by convention the WikiName followed by a dash and the date
• Example:
  -- %BUBBLESIG{TWikiGuest - 2026-02-10}%
• Expands to:
  -- TWiki Guest - 2026-02-10
• Category: EditingAndContentUpdateVariables, FormattingAndRenderingVariables, UsersAndAuthenticationVariables
• Related: USERREPORT, USERSIG, UserList, UserReports (this topic)

GEOLOOKUP -- lookup geo location by IP address or domain name

• The %GEOLOOKUP{}% variable is handled by the GeoLookupPlugin
• Syntax: %GEOLOOKUP{"host" format="..."}%
• Parameters:

  Parameter	Description	Default
  "..."	Host IP address or host name	none, required
  format="..."	Format of geolocation. Supported variables: • $latitude: Latitude • $longitude: Longitude • $city: City name • $region: Region name • $country_name: Country name • $country_code: Two letter country code • $postal_code: Postal code (USA only) • $metro_code: Metropolitan code (USA only) • $area_code: Telephone area code (USA only)	"$city, $region, $country_name"

• Example: %GEOLOOKUP{"75.52.124.86"}% shows default format (city, region, country code)
• Example: %GEOLOOKUP{"75.52.124.86" format="$latitude, $longitude"}% shows comma separated Latitude and Longitude
• Category: AdministrationVariables, ApplicationsAndComponentsVariables, DevelopmentVariables, SecurityAndAccessControlVariables, UsersAndAuthenticationVariables
• Related: GeoLookupPlugin (this topic)

LOGIN -- present a full login link to non-authenticated user

• Present a login link only to users that are not logged in
• Syntax: %LOGIN%
• Expand to: Log In
• Category: LinkingAndNavigationVariables, UsersAndAuthenticationVariables
• Related: TWikiUserAuthentication, LOGINURL, LOGOUT, LOGOUTURL, SESSIONID, SESSIONVAR, SESSION_VARIABLE (this topic)

LOGINURL -- present a login link

• Present a login link, regardless of the state of login
• Syntax: %LOGINURL%
• Expand to: /cgi-bin/login/TWiki06x01/UsersAndAuthenticationVariables?origurl=/cgi-bin/view/TWiki06x01/UsersAndAuthenticationVariables
• Category: LinkingAndNavigationVariables, UsersAndAuthenticationVariables
• Related: TWikiUserAuthentication, LOGIN, LOGOUT, LOGOUTURL, SESSIONID, SESSIONVAR, SESSION_VARIABLE (this topic)

LOGOUT -- present a full logout link to authenticated user

• Present a logout link only to logged in users
• Syntax: %LOGOUT%
• Expand to:
• Category: LinkingAndNavigationVariables, UsersAndAuthenticationVariables
• Related: TWikiUserAuthentication, LOGIN, LOGINURL, LOGOUTURL, SESSIONID, SESSIONVAR, SESSION_VARIABLE (this topic)

LOGOUTURL -- present a logout link

• Present a logout link, regardless of the state of login
• Syntax: %LOGOUTURL%
• Expand to: /cgi-bin/view/TWiki06x01/UsersAndAuthenticationVariables?logout=1
• Category: LinkingAndNavigationVariables, UsersAndAuthenticationVariables
• Related: TWikiUserAuthentication, LOGIN, LOGINURL, LOGOUT, SESSIONID, SESSIONVAR, SESSION_VARIABLE (this topic)

RECENTVISITOR -- show statistics of recent visitors to the TWiki site

• The %RECENTVISITOR{}% variable is handled by the RecentVisitorPlugin
• Most recent visit of an individual:
  • Syntax: %RECENTVISITOR{"user" name="..." format="..."}%
  • Parameters:

    Parameter	Description	Default
    "user" or action="user"	Recent visit of an individual report	(none)
    name="..."	WikiName of person	(currently logged in user)
    format="..."	Format of report. Supported tokens: • $date - date of last visit • $time - time of last visit (GMT) • $ago - how long ago • $ip - IP address (only shown to non-administrators if enabled in configure) • $n, $nop, $quot, $percnt, $dollar - standard FormatTokens.	"Last seen $ago ago"
    notfound="..."	Message shown if user is not found.	"Never seen"

• Report of recent visitors:
  • Syntax: %RECENTVISITOR{"recent" format="..."}%
  • Parameters:

    Parameter	Description	Default
    "recent" or action="recent"	Report of recent visitors	(none)
    format="..."	Format of each line of the report. Supported tokens: • $username - login name of user • $wikiname - WikiName of user • $wikusername - WikiName prefixed with Main web name • plus above tokens.	"   * $wikiusername last seen $ago ago"
    separator="..."	Separator between lines. Standard FormatTokens are expanded.	"$n" (newline)
    limit="..."	Limit the number of lines.	"10"

• Examples:
  • %RECENTVISITOR{"user" name="TWikiAdminUser"}% - show most recent visit of TWikiAdminUser.
  • %RECENTVISITOR{"recent" format="| $wikiusername | $ago ago |}% - show 10 most recent visitors.
• Category: AdministrationVariables, UsersAndAuthenticationVariables
• Related: RecentVisitorPlugin (this topic)

REMOTE_USER -- environment variable

• Syntax: %REMOTE_USER%
• Expands to:
• Category: DevelopmentVariables, SystemInformationVariables, UsersAndAuthenticationVariables
• Related: ENV, HTTP_HOST, REMOTE_ADDR, REMOTE_PORT, USERNAME, WIKINAME, WIKIUSERNAME (this topic)

SESSIONID -- unique ID for this session

• Syntax: %SESSIONID%
• Expand to: 752464e29cc0687f10cf8b8ebfaa8107
• Category: DevelopmentVariables, SystemInformationVariables, UsersAndAuthenticationVariables
• Related: TWikiUserAuthentication, AUTHREALM, SESSIONVAR, LOGIN, LOGOUT, SESSION_VARIABLE (this topic)

SESSION_VARIABLE -- get, set or clear a session variable

• Session variables are stored in a personal "persistent memory space" that is not lost until the web browser is closed
• Syntax: %SESSION_VARIABLE{"name"}% - read a session variable
• Syntax: %SESSION_VARIABLE{"name" set="value"}% - set a session variable
• Syntax: %SESSION_VARIABLE{"name" clear=""}% - clear a session variable
• Special read-only session variables:
  • %SESSION_VARIABLE{"AUTHUSER"}% - user ID, current value:
  • %SESSION_VARIABLE{"SESSION_REQUEST_NUMBER"}% - number of pages accessed by current user since login, current value:
• Note: It is not possible to set/get/clear session variables starting with an underscore, such as "_NON_OF_YOUR_BUSINESS"
• Category: DevelopmentVariables, SystemInformationVariables, UsersAndAuthenticationVariables
• Related: TWikiUserAuthentication, AUTHREALM, GET, LOGIN, LOGOUT, SESSIONID, SESSIONVAR, SET (this topic)

USERINFO{"name"} -- retrieve details about a user

• Syntax: %USERINFO%
• Expands to: guest, TWikiGuest, (comma-separated list of the username, wikiusername, and emails)
• With formatted output, using tokens $emails, $username, $wikiname, $wikiusername, $groups and $admin ($admin returns 'true' or 'false'):
  • Example: %USERINFO{ format="$username is really $wikiname" }%
  • Expands to: guest is really TWikiGuest
• Retrieve information about another user:
  • Example: %USERINFO{ "TWikiGuest" format="$username is really $wikiname" }%
  • Expands to: guest is really TWikiGuest
  • Note: The parameter should be the wikiname of a user. Since TWiki 4.2.1, you can also pass a login name. You can only get information about another user if the {AntiSpam}{HideUserDetails} configuration option is not enabled, or if you are an admin. (User details are hidden in this TWiki)
• Category: SystemInformationVariables, UsersAndAuthenticationVariables
• Related: USERNAME, WIKINAME, WIKIUSERNAME, TWikiUserAuthentication, ChangeEmailAddress (this topic)

USERNAME -- your login username

• TWiki makes names available in three formats: USERNAME like jsmith, WIKINAME like JohnSmith and WIKIUSERNAME like Main.JohnSmith. Un-authenticated users are all TWikiGuest.
• Syntax: %USERNAME%
• Expands to: guest
• Note: When used in a template topic, this variable will be expanded when the template is used to create a new topic. See TWikiTemplates for details.
• Category: SystemInformationVariables, UsersAndAuthenticationVariables
• Related: REMOTE_USER, USERINFO, WIKINAME, WIKIUSERNAME, TWikiUserAuthentication (this topic)

USERREPORT -- show user reports with profile pictures

• Show various user reports documented in UserReports
• Syntax: %USERREPORT{ action="..." ... }%
• Overview of actions with parameters:

  Report	action=	Parameters
  Show a simple list of registered users	"user_list"	search, limit, sort, reverse
  Show the profile picture image of a user	"profile_picture"	user, height, width, title
  Show slim, one line height user boxes	"slim_box_start" "slim_box" or "slim_box_list" "slim_box_end"	style user, style users, style none
  Show small, two line height user boxes	"small_box_start" "small_box" or "small_box_list" "small_box_end"	style user, style users, style none
  Show users in business card format	"business_card_start" "business_card" or "business_card_list" "business_card_end"	style user, style users, style none
  Show a selector to pick a user, for use in HTML forms	"select_one_user"	name, selected, users
  Show rows of checkboxes to select users, for use in HTML forms	"select_users"	name, selected, users, colums, style

• Example: %USERREPORT{ action="user_list" search="jane" limit="5" }%
• Category: AdministrationVariables, DevelopmentVariables, UsersAndAuthenticationVariables
• Related: BUBBLESIG, SEARCH, USERSIG, UserList, UserReports (this topic)

USERSIG -- show user signature with profile picture icon

• Syntax: %USERSIG{WikiName}% or %USERSIG{WikiName - YYYY-MM-DD}%
• The parameter can be either just the WikiName of a user, or by convention the WikiName followed by a dash and the date
• Example:
  -- %USERSIG{TWikiGuest - 2026-02-10}%
• Expands to:
  -- TWiki Guest - 2026-02-10
• Category: EditingAndContentUpdateVariables, FormattingAndRenderingVariables, UsersAndAuthenticationVariables
• Related: BUBBLESIG, USERREPORT, UserList, UserReports (this topic)

WIKINAME -- your Wiki username

• The WikiName is the same as %USERNAME% if not defined in the TWikiUsers topic
• Syntax: %WIKINAME%
• Expands to: TWikiGuest
• Note: When used in a template topic, this variable will be expanded when the template is used to create new topic. See TWikiTemplates for details.
• Category: SystemInformationVariables, UsersAndAuthenticationVariables
• Related: REMOTE_USER, USERINFO, USERNAME, WIKIUSERNAME, WIKIUSERSTOPIC (this topic)

WIKIUSERNAME -- your Wiki username with web prefix

• Your %WIKINAME% with Main web prefix, useful to point to your user profile page
• Syntax: %WIKIUSERNAME%
• Expands to: Main.TWikiGuest, renders as TWikiGuest
• Note: When used in a template topic, this variable will be expanded when the template is used to create a new topic. See TWikiTemplates for details
• Category: SystemInformationVariables, UsersAndAuthenticationVariables
• Related: REMOTE_USER, USERINFO, USERNAME, WIKINAME (this topic)

WIKIUSERSTOPIC -- name of topic listing all registers users

• Syntax: %WIKIUSERSTOPIC%
• Expands to: TWikiUsers, with Main prefix renders as TWikiUsers
• Category: SystemInformationVariables, UsersAndAuthenticationVariables
• Related: WIKIUSERNAME (this topic)

Total: 18 variables

Related Topics: TWikiVariables, TWikiVariablesSearch, TWikiVariablesQuickStart