Skip to main content
Message overrides let you replace the default on-screen text in the pre-built UI with your own wording. You can reword the headings, descriptions, and button or link labels for each authentication method, so the screens your users see match your product’s voice. Overrides are set per language, so you can tailor the copy for every locale your users authenticate in.

​
Editing your messages

1

Open message overrides

In the Authsignal Portal, go to Settings → Pre-built UI → Message overrides.
2

Select a screen

Choose a screen from the list on the left. Screens are grouped by authentication method, and each shows how many fields you’ve already overridden for the selected language.
3

Edit the copy

Update any field. A live preview on the right shows the screen in your tenant’s theme as you type. Leave a field blank to keep the Authsignal default.
4

Save your changes

Select Save changes. Your overrides take effect in the pre-built UI.
Every field is optional. When a field is left empty, the pre-built UI shows the Authsignal default copy for that language. Clearing a field you previously overrode reverts it to the default.

​
Working with languages

Overrides are stored per language. Use the language selector at the top of the page to switch between the languages you support, and edit one language at a time. Any field you don’t override falls back to the Authsignal default copy for that language, so you only need to set the messages you want to change. For the full list of supported languages and how the pre-built UI chooses which one to show, see Localization.

​
Dynamic values

Some fields can include dynamic values that Authsignal fills in at runtime, such as your tenant name or the user’s masked identifier. These appear in double curly braces, for example {{tenantName}}. Use the insert buttons above a field to add the dynamic values it supports. Each field allows only a specific set of values.

​
Saving, discarding, and resetting

  • Save changes stores your overrides. If a field has an error, such as an unsupported dynamic value or text over the character limit, saving is disabled and the editor points you to the field that needs fixing.
  • Discard undoes any unsaved edits and restores your last saved version.
  • Reset all removes every override across all languages and returns the pre-built UI to the Authsignal defaults.
To revert a single field, clear it and save.

​
Next steps

Localization

Set the language and locale of the pre-built UI for your users.

Custom branding

Customize the colors, fonts, and layout of the pre-built UI.

Contextual messaging

Add per-action context to a challenge in the pre-built UI.