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 Branding, SMS Template settings.

Note: All templates must includes the {{.magic_link.url}}

Template types

There are three SMS templates you can customize. All templates utilize template variables. View the full set of template variables.

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.

Change phone number

SMS is sent when a user initiates an phone number change from their profile.

Validate phone number

SMS is sent upon register when verification required is enabled in your app settings.

Creating a template

Select template type

Select the template type you would like to customize.

Define custom message

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.

Save message

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.