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

# Contextual messaging

> Add custom messaging to the pre-built UI to give your users more context.

The contextual messaging feature allows you to provide additional information to users when they're completing a challenge in the pre-built UI.

## Creating a contextual message

To configure messaging for your action:

1. Navigate to the [Authsignal Portal actions page](https://portal.authsignal.com/actions)
2. Select your action
3. Go to the **Messaging** tab

<Frame caption="Contextual messaging configuration in the Authsignal Portal">
  <img src="https://mintcdn.com/authsignal-23/8bvDamO56aVu-Ay2/images/docs/customizations/contextual-message-page.png?fit=max&auto=format&n=8bvDamO56aVu-Ay2&q=85&s=41afc11ceec8546737be190ade45a42a" alt="" width="1227" height="820" data-path="images/docs/customizations/contextual-message-page.png" />
</Frame>

## Dynamic content with custom data points

You can enrich your messages with dynamic data using the syntax: `{{<context>.<dataPointName>}}`

<Frame caption="Inserting dynamic data into your message">
  <img src="https://mintcdn.com/authsignal-23/8bvDamO56aVu-Ay2/images/docs/customizations/contextual-message-data-insert.png?fit=max&auto=format&n=8bvDamO56aVu-Ay2&q=85&s=5f7936906a9d3d95a077e9edc84192a7" alt="" width="1016" height="682" data-path="images/docs/customizations/contextual-message-data-insert.png" />
</Frame>

### Using action data

To include transaction-specific information (such as withdrawal amount):

```
You will be withdrawing {{action.withdrawalAmount}}
```

<Note>
  Make sure to include these custom data points in your [track action
  payload](/actions-rules/rules/custom-data-points#3-send-the-custom-data-in-your-code).
</Note>

### Using user data

To include user-specific information:

```
Welcome back, {{user.firstName}}. Please confirm this withdrawal of {{action.withdrawalAmount}}.
```

<Note>
  Ensure you have [updated your user profile](/api-reference/server-api/update-user) with these
  custom data points before referencing them.
</Note>

## Pre-built UI

Once you've created a contextual message, it will be displayed in the pre-built UI when the user is completing the challenge.

<Warning>
  If any of the data points you're referencing are not available, the message will not be displayed.
</Warning>

<Frame caption="Contextual message in the pre-built UI">
  <img src="https://mintcdn.com/authsignal-23/8bvDamO56aVu-Ay2/images/docs/customizations/contextual-message-pre-built-ui.png?fit=max&auto=format&n=8bvDamO56aVu-Ay2&q=85&s=299497d1fc7e8e63abe8d9b54d64156c" alt="" width="690" height="647" data-path="images/docs/customizations/contextual-message-pre-built-ui.png" />
</Frame>
