SMS customization

You can customize the text of the SMS messages that are sent to your end users for MFA verification. Although Okta supports many variables for use in email templates, SMS messages support only ${code} (required) and ${org.name} (optional).

Edit the Okta Standard SMS (Default)

To view the Standard SMS message, click the Default expand button. The default message is: Your verification code is ${code}.

  1. In Admin Console, go to Settings > Email & SMS.
  2. Click the SMS tab. In Custom Language, click the pencil icon under Actions.
  3. Edit the text of the default SMS message. Include the required variable ${code}. The variable ${org.name} is optional.
    Info

    Note

    Messages are limited to 159 characters.

  4. Click Save.

Customize the SMS message with Translation (Language)

You can the change language of the SMS message that is sent to your end users.

  1. In Admin Console, go to Settings > Email & SMS.

  2. Click the SMS tab. Under Custom Language, click Add Translation.
  3. Select a language from the Language drop-down menu.
  4. Using the chosen language, enter a message in the field. Include the required variable ${code} (${org.name} is optional).
  5. Click Add Translation when done.

The custom language is shown under Default. Your customization is saved and you are no longer using the default Okta message.

To reset the message back to the Okta Standard SMS message, click Reset to Default and follow the prompts.

When crafting your custom message, keep the following in mind:

  • The maximum length of the message is 159 characters.
  • The OTP placeholder, ${code}, is included in the message length count.
  • The message can include only alphanumeric and punctuation characters. Avoid using special characters.