> ## Documentation Index
> Fetch the complete documentation index at: https://docs.authsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Message overrides

> Replace the default on-screen text in the pre-built UI with your own wording.

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

<Steps>
  <Step title="Open message overrides">
    In the [Authsignal Portal](https://portal.authsignal.com), go to **Settings → Pre-built UI → Message overrides**.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Save your changes">
    Select **Save changes**. Your overrides take effect in the pre-built UI.
  </Step>
</Steps>

<Note>
  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.
</Note>

## 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](/implementation-options/prebuilt-ui/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

<CardGroup cols={2}>
  <Card title="Localization" icon="language" href="/implementation-options/prebuilt-ui/localization">
    Set the language and locale of the pre-built UI for your users.
  </Card>

  <Card title="Custom branding" icon="palette" href="/implementation-options/prebuilt-ui/custom-branding">
    Customize the colors, fonts, and layout of the pre-built UI.
  </Card>

  <Card title="Contextual messaging" icon="message" href="/implementation-options/prebuilt-ui/contextual-messaging">
    Add per-action context to a challenge in the pre-built UI.
  </Card>
</CardGroup>