Theme Template Variables

The application resolved by the provided client_id provided on the request. If the request was made without a client_id then this variable will be undefined. Ensure you reference it using a null safe strategy if you are using some of the themed pages without a client_id.

See the Application API for details on this object.

The OAuth v2.0 client_id parameter. This is synonymous with FusionAuth's Application Id.

When there is an active SSO session, this variable will contain the currently logged in user. When an SSO session does not yet exist, this variable will be null. If the user has not checked the Keep me signed in option, there is no SSO session and this variable will be null.

See the User API for details on this object.

A list of error messages that were generated during the processing of the request.

A map of field messages (usually errors) that were generated during the processing of the request. The key into the map is the name of the form field and the value is a list that contains the errors for that form field.

The locale used to localize messages.

You can find the JavaDoc for this object available here: https://docs.oracle.com/javase/8/docs/api/java/util/Locale.html

The HttpServletRequest object that is part of the Java Servlet specification.

You can find the JavaDoc for this object available here: https://docs.oracle.com/javaee/6/api/javax/servlet/http/HttpServletRequest.html

The tenant that has been resolved for this template. This value has either been specified on the request by providing the tenantId request parameter or it has been resolved by other request parameters such as the client_id.

If you need to customize the look and feel for different tenants but desire to use the same theme to lower maintenance, store values in tenant.data. For example, you could set tenant.data.customElements.buttonText and tenant.data.customElements.buttonColor, then retrieve values off these fields in the theme templates.

See the Tenant API for details on this object.

The unique Tenant identifier, this is equivalent to tenant.id.

The theme that has been resolved for this template. This could be resolved based on the tenant or the application.

See the Themes API for details on this object.

The unique Theme identifier, this is equivalent to theme.id.

The User fields to display in the form. Each key maps to form fields by section within a Self-Service User form.

A boolean that indicates if the user has a password set.

The URL back to the application that referred the user into the account pages. FusionAuth resolves this from the redirect_uri request parameter, falling back to the Referer header when the user navigated directly from your application. This variable will be undefined when neither is available, or when the user arrived from another FusionAuth page, so reference it using a null safe strategy. Account pages share this value using the redirect_uri request parameter.

The User object corresponding to the authenticated user.

A boolean that indicates if a Self-Service User form has been configured for this application.

A boolean that indicates if any multi-factor authentication methods have been enabled on the tenant.

The URL back to the application that referred the user into the account pages. FusionAuth resolves this from the redirect_uri request parameter, falling back to the Referer header when the user navigated directly from your application. This variable will be undefined when neither is available, or when the user arrived from another FusionAuth page, so reference it using a null safe strategy. Account pages share this value using the redirect_uri request parameter.

The User object corresponding to the authenticated user.

A boolean that indicates if WebAuthn has been enabled on the tenant.

The email address you are attempting to disable, this will be available when the method is email.

The two-factor method you are disabling. The possible values are:

• authenticator
• email
• sms

The actual Id of the two-factor method you are disabling.

The mobile phone you are attempting to disable, this will be available when the method is sms.

The URL back to the application that referred the user into the account pages. FusionAuth resolves this from the redirect_uri request parameter, falling back to the Referer header when the user navigated directly from your application. This variable will be undefined when neither is available, or when the user arrived from another FusionAuth page, so reference it using a null safe strategy. Account pages share this value using the redirect_uri request parameter.

The User object corresponding to the authenticated user.

The two-factor methods that are available to be configured.

The email address if the method value is email.

The two-factor method. The possible values are:

• authenticator
• email
• sms

The mobile phone if the method is sms.

The URL back to the application that referred the user into the account pages. FusionAuth resolves this from the redirect_uri request parameter, falling back to the Referer header when the user navigated directly from your application. This variable will be undefined when neither is available, or when the user arrived from another FusionAuth page, so reference it using a null safe strategy. Account pages share this value using the redirect_uri request parameter.

A Base64 encoded secret for the authenticator method.

A Base32 encoded form of the provided secret for the authenticator method.

The User object corresponding to the authenticated user.

The two-factor methods that are available to be configured.

The email address if the method value is email.

The two-factor method. The possible values are:

• authenticator
• email
• sms

The mobile phone if the method is sms.

The recovery codes when a user configured multi-factor authentication for the first time. This will be available after a method has been successfully enabled and this template is rendered a second time. If you already have one method enabled, the recovery codes will not be displayed.

The URL back to the application that referred the user into the account pages. FusionAuth resolves this from the redirect_uri request parameter, falling back to the Referer header when the user navigated directly from your application. This variable will be undefined when neither is available, or when the user arrived from another FusionAuth page, so reference it using a null safe strategy. Account pages share this value using the redirect_uri request parameter.

A Base64 encoded secret for the authenticator method.

A Base32 encoded form of the provided secret for the authenticator method.

The User object corresponding to the authenticated user.

The URL back to the application that referred the user into the account pages. FusionAuth resolves this from the redirect_uri request parameter, falling back to the Referer header when the user navigated directly from your application. This variable will be undefined when neither is available, or when the user arrived from another FusionAuth page, so reference it using a null safe strategy. Account pages share this value using the redirect_uri request parameter.

The User object corresponding to the authenticated user.

The URL back to the application that referred the user into the account pages. FusionAuth resolves this from the redirect_uri request parameter, falling back to the Referer header when the user navigated directly from your application. This variable will be undefined when neither is available, or when the user arrived from another FusionAuth page, so reference it using a null safe strategy. Account pages share this value using the redirect_uri request parameter.

The User object corresponding to the authenticated user.

The WebAuthn passkey the user is deleting. See the WebAuthn API for details on this object.

The URL back to the application that referred the user into the account pages. FusionAuth resolves this from the redirect_uri request parameter, falling back to the Referer header when the user navigated directly from your application. This variable will be undefined when neither is available, or when the user arrived from another FusionAuth page, so reference it using a null safe strategy. Account pages share this value using the redirect_uri request parameter.

The URL back to the application that referred the user into the account pages. FusionAuth resolves this from the redirect_uri request parameter, falling back to the Referer header when the user navigated directly from your application. This variable will be undefined when neither is available, or when the user arrived from another FusionAuth page, so reference it using a null safe strategy. Account pages share this value using the redirect_uri request parameter.

The list of registered WebAuthn passkeys for the current user. See the WebAuthn API for details on this object.

The URI to return to once confirmation has been provided.

The reason the user is being prompted for confirmation.

The email address that requested to receive a new email verification request.

When true, an additional form is displayed to allow the user to update their email address. This is intended to assist the user if they mis-typed their email address previously. This occurs when Allow email change when gated is enabled under email verification settings on the Tenant.

When true, a form input is displayed to allow a user to enter the verification code. This occurs when Verification strategy is set to FormField under email verification settings on the Tenant.

The current value of the user's email address. This may be useful to indicate to the user which email address was sent a verification code.

A boolean that controls whether or not to include captcha scripts and show the captcha challenge (or message for invisible captcha).

The verification Id that was included on as a URL parameter. This is the high entropy value that will be paired with the low entropy one time code to complete email verification.

Defaults to true on this page.

A boolean that controls whether or not to include captcha scripts and show the captcha challenge (or message for invisible captcha).

The verification Id that was included on as a URL parameter but was invalid. This page does a redirect if the verificationId is valid.

A boolean that indicates if the WebAuthn bootstrap workflow is enabled for the current application.

The OAuth v2.0 code_challenge parameter.

The OAuth v2.0 code_challenge_method parameter used in conjunction with PKCE. Can be either plain or S256.

The PendingIdpLink that is generated when using the device OAuth flow. This object provides information about the current state of the user and the identity provider prior to completing the link. This is available when linking or registering a device ( i.e. Playstation or XBox).

A human readable name for this link to help you identify this link. This value will generally be an email address, or username.

The email address of the FusionAuth user being linked to the identity provider.

See the Link API for details on this object.

The name of the identity provider that is being linked to.

The type of identity provider that is being linked to.

The Id for the User that is provided by the identity provider.

A boolean that indicates if a user has exceeded the maximum number of links allowed.

The FusionAuth user that is linked to the identity provider.

The username of the FusionAuth user being linked to the identity provider.

A boolean that indicates if there are domain-based identity providers configured. These identity providers use the user's email address to determine if an external IdP should be used to log the user in.

A map of the configured identity providers for the Application the user is logging into. The key into the map is the type of the identity provider (i.e. Facebook or OpenIDConnect). The value is a list of all of the configured identity providers for that type. + NOTE: This map does not contain any "domain-based" identity providers since those are handled differently using just the Email input field to start and then possibly redirecting the browser to the external IdP login page.

The value from the loginId form field. This is the email, phone number, or username of the user attempting to log into FusionAuth.

Metadata on when the JWT Refresh Token was created

The OpenID Connect nonce request parameter.

A boolean that controls whether or not to to utilize a passwordless flow.

This is the unique value when creating a link between a unique UUID returned by the IdP and a new or existing FusionAuth user.

A human readable name for this link to help you identify this link. This value will generally be an email address, or username.

The email address of the FusionAuth user being linked to the identity provider.

See the Link API for details on this object.

The name of the identity provider that is being linked to.

The type of identity provider that is being linked to.

The Id for the User that is provided by the identity provider.

A boolean that indicates if a user has exceeded the maximum number of links allowed.

The FusionAuth user that is linked to the identity provider.

The username of the FusionAuth user being linked to the identity provider.

The OAuth v2.0 redirect_uri parameter. This is the URI that FusionAuth will redirect the user to once they have successfully logged in.

This value is used to record if ths user would like to have their device remembered on the next login.

The OAuth v2.0 response_type parameter.

The OAuth v2.0 scope parameter.

A boolean that controls whether or not to include captcha scripts and show the captcha challenge (or message for invisible captcha).

A boolean that controls whether the password field is shown if there are domain-based identity providers. If there are domain based identity providers and the user types in an email address that is not managed by the identity provider, FusionAuth will then re-render this template with this variable set to true. This will indicate that the password field should be shown so that the user can complete their login. If you need an example of this behavior, check out the login page at https://www.pivotaltracker.com/signin.

A boolean that indicates if the WebAuthn re-authentication workflow is enabled for the current application, and there are re-authentication passkeys available on the current device.

The OAuth v2.0 state parameter.

The timezone that the user is in. This is normally guessed by the timezone JavaScript library (or something similar) and then stored in a hidden input field on the login form.

The user code provided by the user in the form, or if the user_code was provided on the URL using a request parameter such as ?user_code=123 this value will be provided in the template using this variable.

The version.

The parent's email address provided in the input field of the form.

The User fields to display in the form. Each key maps to form fields by section within a Self-Service User form.

A boolean that indicates if the user has a password set.

(for Advanced Registration Forms only) The step in the registration process according to the form in use. The value will be 1 for the first step, 2 for the second step, and so on.

(for Advanced Registration Forms only) The total number of steps in the registration form.

The action the user selected on the consent prompt. The value should be allow if the user made consent selections and wants to continue or cancel if they have decided not to continue.

The list of OAuth scopes on the request with optional user consent. See the Scope API for details on this object.

The list of OAuth scopes on the request that require user consent. See the Scope API for details on this object.

A map of OAuth scope consent choices made by the user. The key into the map is the OAuth scope name. The value should be true if the user has consented to the scope or false if they have declined.

The list of unknown OAuth scope names on the request if the application is configured to Allow unknown scopes.

The PendingIdpLink that is generated when using the device OAuth flow. This object provides information about the current state of the user and the identity provider prior to completing the link. This is available when linking or registering a device ( i.e. Playstation or XBox).

A human readable name for this link to help you identify this link. This value will generally be an email address, or username.

The email address of the FusionAuth user being linked to the identity provider.

See the Link API for details on this object.

The name of the identity provider that is being linked to.

The type of identity provider that is being linked to.

The Id for the User that is provided by the identity provider.

A boolean that indicates if a user has exceeded the maximum number of links allowed.

The FusionAuth user that is linked to the identity provider.

The username of the FusionAuth user being linked to the identity provider.

The user code provided by the user in the form, or if the user_code was provided on the URL using a request parameter such as ?user_code=123 this value will be provided in the template using this variable.

The length of the interactive user code. This value may be used to build the correct number of input fields for the interactive code.

An optional parameter that may be present if the completion of this device request resulted in one or more Identity Provider links being established to this user. + This variable may be helpful if you wish to communicate to the user which links have been completed.

The OAuth error JSON that could be helpful for developers while debugging.

A set of URLs associated with all of the applications in the tenant to log out the user.

The URL to be redirected to after the front-channel logout occur.

A set of URLs associated with all of the applications the user is registered for to log out the user.

The OAuth v2.0 redirect_uri parameter. This is the URI that FusionAuth will redirect the user to once they have successfully logged in.

The OAuth v2.0 response_type parameter.

The OAuth v2.0 scope parameter.

A boolean that controls whether or not to include captcha scripts and show the captcha challenge (or message for invisible captcha).

The OAuth v2.0 state parameter.

The timezone that the user is in. This is normally guessed by the timezone JavaScript library (or something similar) and then stored in a hidden input field on the login form.

Whether or not to collect a birth date for a Consent workflow.

Whether or not to render a hidden field for passing along the birthdate in the form.

Whether or not a parent's email address is required for a Consent Workflow.

An object that contains the password validation rules. The object fields are defined in keys to this object, as defined below.

The maximum length of a password.

The minimum length of a password.

The number of previous passwords the user is not allowed to re-use.

Whether or not the user must use upper and lower-cased letter.

Whether or not the user must use at least one non-alphabetic character in their password.

Whether or not the user must use at least one numeric character in their password.

A boolean that controls whether or not to include captcha scripts and show the captcha challenge (or message for invisible captcha).

The PendingIdpLink that is generated when using the device OAuth flow. This object provides information about the current state of the user and the identity provider prior to completing the link. This is available when linking or registering a device ( i.e. Playstation or XBox).

A human readable name for this link to help you identify this link. This value will generally be an email address, or username.

The email address of the FusionAuth user being linked to the identity provider.

See the Link API for details on this object.

The name of the identity provider that is being linked to.

The type of identity provider that is being linked to.

The Id for the User that is provided by the identity provider.

A boolean that indicates if a user has exceeded the maximum number of links allowed.

The FusionAuth user that is linked to the identity provider.

The username of the FusionAuth user being linked to the identity provider.

This is the unique value when creating a link between a unique UUID returned by the IdP and a new or existing FusionAuth user.

A human readable name for this link to help you identify this link. This value will generally be an email address, or username.

The email address of the FusionAuth user being linked to the identity provider.

See the Link API for details on this object.

The name of the identity provider that is being linked to.

The type of identity provider that is being linked to.

The Id for the User that is provided by the identity provider.

A boolean that indicates if a user has exceeded the maximum number of links allowed.

The FusionAuth user that is linked to the identity provider.

The username of the FusionAuth user being linked to the identity provider.

A boolean that indicates if the application is configured for self registration.

The value of the code form field on the page. This will be available only after the user has submitted the form.

The currently selected two-factor method. This may be helpful if you want to communicate to the end user their currently selected method. + For example, method.method will indicate the type of method, authenticator, email or sms. Based upon the method, the method.email or method.mobilePhone will indicate which transport is being used to send the user a code.

The method Id. This Id, if defined, will represent the currently selected method, or last used method.

Whether or not FusionAuth has pushed (SMS) enabled for two-factor.

Whether or not the user prefers push (SMS) for two-factor.

The OAuth v2.0 redirect_uri parameter. This is the URI that FusionAuth will redirect the user to once they have successfully logged in.

Whether or not the user wants the code to be resent to their phone (valid for push two-factor).

The OAuth v2.0 response_type parameter.

The OAuth v2.0 scope parameter.

Whether or not to display a link to allow the user to select a different method or resend the code. This value will be true when more than one option exist for the user to select, or the available method is email or sms which will allow for a resend option.

The OAuth v2.0 state parameter.

The timezone that the user is in. This is normally guessed by the timezone JavaScript library (or something similar) and then stored in a hidden input field on the login form.

The value of the "Trust this computer" form field. This will be available only after the user has submitted the form. Otherwise, it defaults to false. When the user checks this box, a cookie is dropped so that two-factor authentication can be skipped on this computer.

The unique Id of the current multi-factor authentication attempt.

Whether or not the user is capable of receiving push notifications for two-factor. This means that the user has a mobile phone number.

The two-factor methods that are available to be configured.

Returned when twoFactorId is provided to complete Two Factor login.

The email address if the method value is email.

The two-factor method. The possible values are:

• authenticator
• email
• sms

The mobile phone if the method is sms.

A base64 encoded version of the secret that can be used to build a QR code when using the authenticator method.

A base32 encoded version of the secret that can be used to build a QR code when using the authenticator method.

The recovery codes when a user configured multi-factor authentication for the first time. This will be available after a method has been successfully enabled and this template is rendered a second time. If you already have a method enabled, the recovery codes will not be displayed.

A map of two-factor methods that the user has configured. The key into the map is the unique methodId. The value is the two-factor method.

The method Id. This Id, if defined, will represent the currently selected method, or last used method.

The total number of recovery codes that the user has available to use.

The timezone that the user is in. This is normally guessed by the timezone JavaScript library (or something similar) and then stored in a hidden input field on the login form.

The unique Id of the current multi-factor authentication attempt.

The FusionAuth temporary code used to complete this external authentication request.

A boolean that controls whether or not to include captcha scripts and show the captcha challenge (or message for invisible captcha).

A list of the WebAuthn passkeys available to complete re-authentication on the current device. See the WebAuthn API for details on this object.

A list of the current user's registered WebAuthn passkeys that may be suitable for use in the re-authentication workflow. See the WebAuthn API for details on this object.

The Id that was sent to the user (usually via email or SMS) that allows them to change their password. Normally, this Id is included in the template for the forgot password workflow and when the user clicks the link in the message, they are taken to this page with this parameter on the URL.

An object that contains the password validation rules. The object fields are defined in keys to this object, as defined below.

The maximum length of a password.

The minimum length of a password.

The number of previous passwords the user is not allowed to re-use.

Whether or not the user must use upper and lower-cased letter.

Whether or not the user must use at least one non-alphabetic character in their password.

Whether or not the user must use at least one numeric character in their password.

A boolean that controls whether or not to include captcha scripts and show the captcha challenge (or message for invisible captcha).

A boolean that controls whether or not to include captcha scripts and show the captcha challenge (or message for invisible captcha).

The email address that requested to receive a change password request.

The login Id that requested to receive a change password request.

The phone number that requested to receive a new verification request message.

When true, a form input is displayed to allow a user to enter the verification code. This occurs when Verification strategy is set to FormField under identities/phone verification settings on the Tenant.

The current value of the user's phone number. This may be useful to indicate to the user which phone number was sent a verification code.

A boolean that controls whether or not to include captcha scripts and show the captcha challenge (or message for invisible captcha).

The verification Id that was included on as a URL parameter. This is the high entropy value that will be paired with the low entropy one time code to complete phone number verification.

Defaults to true on this page.

A boolean that controls whether or not to include captcha scripts and show the captcha challenge (or message for invisible captcha).

The verification Id that was included on as a URL parameter but was invalid. This page does a redirect if the verificationId is valid.

The Id of the application that the user is verifying their email for and needs the email to be resent.

The email address that requested to receive a new registration verification request.

When true, a form input is displayed to allow a user to enter the verification code. This occurs when Verification strategy is set to FormField under registration verification settings on the Application.

A boolean that controls whether or not to include captcha scripts and show the captcha challenge (or message for invisible captcha).

The verification Id that was included on as a URL parameter. This is the high entropy value that will be paired with the low entropy one time code to complete email verification.

A boolean that controls whether or not to include captcha scripts and show the captcha challenge (or message for invisible captcha).

The verification id that was included on as a URL parameter but was invalid. This page does a redirect if the verificationId is valid.

A set of URLs associated with all of the applications in the tenant to log out the user.

A set of URLs associated with all of the applications the user is registered for to log out the user.

A string that defines why the user has been redirected to this page.

A string that defines the Id of each security incident generated by the Advanced Threat Detection suite.