Updated Date: 07/07/2026
Okta MFA page settings
You can customize the following settings for the Okta MFA agent (added to a subroutine or macro). These settings are available for per-request policies configured with the Customization Type set to Modern or Standard. The settings are divided into the following sections: Okta Verify Settings, Okta Enrollment Settings, Yubikey Settings, Navigation Settings, and General Settings.
| Name | Value | Description |
|---|---|---|
| Code error caption | Text | Specifies the message to display if the user typed the code incorrectly. |
| Display name for Okta Verify factor | Text | Specifies the title on the MFA screen, such as Okta verify. |
| Enter code caption | Text | Specifies the label requesting a code, such as Or enter code. |
| Push caption | Text | Specifies the label requesting Push authentication, such as Send push. |
| TOTP caption | Text | Specifies the label asking for the code provided for TOTP authentication, such as Enter code. |
| Name | Value | Description |
|---|---|---|
| Activation email link sent message | Text | Specifies the text of the message when the Activation link has been sent to your registered email at Okta account. |
| Activation sms link sent message | Text | Specifies the text of the message when the Activation link has been sent to your cell phone, which is included dynamically in the message. |
| Add account using secret key message | Text | Specifies the text when the user is enrolling using a secret key. For example: Enter your username and below secret key in Okta MFA App to add account. |
| Can’t scan QR Code caption | Text | Specifies the text to display if the QRCode cannot be scanned. For example: More options to enroll. |
| Download mobile app and QRCode scan description | Text | Specifies the instructions to download the Okta Verify mobile app. For example: Download and launch Okta Verify application on your mobile device and select Add an account to scan QR code. |
| Invalid Phone number error | Text | Specifies the text asking the user to enter a valid phone number. |
| Multifactor authentication enrollment setup text | Text | Specifies the message that the user needs to set up MFA authentication. For example: Company requires multifactor authentication to use additional layer of security when signing in to your account. |
| Okta Verify enrollment setup message | Text | Specifies that the user must set up multifactor authentication for Okta Verify. |
| Please enter phone number | Text | Specifies the text asking the user to enter a phone number. |
| Send link via email caption | Text | Specifies the caption for the button to enroll via email. |
| Send link via Sms caption | Text | Specifies the caption for the button to enroll via SMS. |
| Setup without push caption | Text | Specifies the caption for the Setup without sending a push, such as Enroll manually without push. |
| Text shown to upgrade to Push | Text | Specifies the caption to upgrade to Push. |
| Name | Value | Description |
|---|---|---|
| Display name for Yubikey factor | Text | Specifies the caption to select YubiKey authentication. |
| Yubikey message | Text | Specifies the text that explains how to use the YubiKey for authentication, such as Insert your YubiKey into a USB port and tap it to generate a verification code. |
| Name | Value | Description |
|---|---|---|
| Back caption | Text | Specifies the caption for the Back button. |
| Fisish caption | Text | Specifies the caption for the Finish button. |
| Next caption | Text | Specifies the caption for the Next button. |
| Verify caption | Text | Specifies the caption for the Verify button. |
| Name | Value | Description |
|---|---|---|
| Enrollment text shown along with factor name. Factor name will be added dynamically | Text | Specifies the enrollment and factor. To retrieve the factor, specify [FACTOR_NAME] anywhere in the text exactly as shown. |
| Setup more factors message | Text | Specifies the text for the option to set up additional factors. |
| Text shown on successful enrollment with factor name. Factor name will be added dynamically | Text | Specifies the text to display upon successful enrollment of a new factor. To retrieve the factor, specify [FACTOR_NAME] anywhere in the text exactly as shown. |