SMS customization

You can customize the text of the SMS messages that are sent to your end usersEnd users are people in your org without administrative control. They can authenticate into apps from the icons on their My Applications home page, but they are provisioned, deprovisioned, assigned, and managed by admins. for MFA verification. Although Okta supports many variables for use in email templates, SMS messages support only ${code} (required) and ${orgThe Okta container that represents a real-world} (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 AdminAn abbreviation of administrator. This is the individual(s) who have access to the Okta Administrator Dashboard. They control the provisioning and deprovisioning of end users, the assigning of apps, the resetting of passwords, and the overall end user experience. Only administrators have the Administration button on the upper right side of the My Applications page. Console, go to Settings > Email & SMS Customization.
  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 ${} is optional.


    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 Customization.

  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} (${} 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.