Custom SMS Messages

Customize the body of your SMS based authentication messages

Passage allows you to customize the body of a SMS to match your brands voice and build trust with your user base. In the Passage Console navigate to Branding --> SMS Templates.

Template types

There are three SMS templates you can customize:

Magic Link Login

SMS is sent when a user attempts to register or login with a magic link, or when they login on a new device for the first time when using a phone number as their identifier. The full set of template variables can be found here, but you must includes the {{.magic_link.url}} which is the link that enables the user to login.

Change Phone Number

SMS is sent when a user initiates an phone number change from their profile. The full set of template variables can be found here, but you must includes the {{.magic_link.url}} which is the link that enables the user to verify and complete their phone number change.

Validate Phone Number

SMS is sent upon register when verification required is enabled in your app settings. The full set of template variables can be found here, but you must includes the {{.magic_link.url}} which is the link that enables the user to verify and complete their phone number verification.

Creating a template

• Select the template type you would like to customize

• In the Message Body section, define your custom message

It is recommended that messages stay under 300 characters so they are not split into multiple message or be too large to send

• Press "Save"

  • This will save the message but will not enable the custom template

Enable a template

You will need to configure a SMS provider to enable custom SMS templates

Once you've saved your new SMS message it's time to let Passage know to send your custom option for this SMS type. You can do this by moving the "Enabled" toggle to "On". Once toggled to "On" this template is live.

Note: Enabling a SMS configuration is per SMS type - use the tab under SMS Templates in the UI to switch SMS types.