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

# How to Use Test Events

> Use Test Events in the Template Designer to preview and validate variables, branding, and message content across channels before sending.

This step-by-step guide helps you define test events and use the preview function across multiple delivery channels.

## Previewing Your Notification

To preview a notification, open it in the designer and select the **Preview** tab.

<Frame caption="Notification Preview">
  <img src="https://mintcdn.com/courier-4f1f25dc/oLXFxRwf6FuGv1s3/assets/platform/content/preview-notification-tab.png?fit=max&auto=format&n=oLXFxRwf6FuGv1s3&q=85&s=7f4aee3c620cb4e1ea8d3360bef385d9" alt="Notification Preview" width="651" height="242" data-path="assets/platform/content/preview-notification-tab.png" />
</Frame>

## Using Test Events

When you initially open the preview tab on the demo Welcome to Courier email, there will be a generic "Welcome Example" event with an empty profile.

Any variables you insert into the template will not render until you add your own custom test event or update the JSON of the Welcome Example.

<Frame caption="New Test Event">
  <img src="https://mintcdn.com/courier-4f1f25dc/oLXFxRwf6FuGv1s3/assets/platform/content/preview-notification-test-event.png?fit=max&auto=format&n=oLXFxRwf6FuGv1s3&q=85&s=722f9a2903c5edaaa7d1ad94ce7f9f4b" alt="New Test Event" width="1856" height="1156" data-path="assets/platform/content/preview-notification-test-event.png" />
</Frame>

<Note>
  To send a test email or SMS via the [Send Tab](/platform/content/template-designer/template-designer-overview), you need to include an email and/or phone number in the `profile` object of the test event JSON.
</Note>

<Frame caption="Your Test Event Needs a Complete Profile">
  <img src="https://mintcdn.com/courier-4f1f25dc/oLXFxRwf6FuGv1s3/assets/platform/content/preview-notification-test-variable.png?fit=max&auto=format&n=oLXFxRwf6FuGv1s3&q=85&s=4ae61afc0bfed933dbb98361d7527026" alt="Your Test Event Needs a Complete Profile" width="433" height="159" data-path="assets/platform/content/preview-notification-test-variable.png" />
</Frame>

## Previewing Variables

To preview and validate any variables you've built into your notification, create a test event:

<Steps>
  <Step title="Manage Test Events">
    Click **Manage Test Events** in the Preview tab.

    <Frame caption="Test Event Variables">
      <img src="https://mintcdn.com/courier-4f1f25dc/oLXFxRwf6FuGv1s3/assets/platform/content/preview-notification-test-manage.png?fit=max&auto=format&n=oLXFxRwf6FuGv1s3&q=85&s=26b6d6d8bb177f84a89f4d8b004c1acd" alt="Test Event Variables" width="889" height="680" data-path="assets/platform/content/preview-notification-test-manage.png" />
    </Frame>
  </Step>

  <Step title="Add Your JSON Data">
    Add valid JSON with values in the `data` and/or `profile` objects for your variables.

    <Frame caption="Test Event Name">
      <img src="https://mintcdn.com/courier-4f1f25dc/oLXFxRwf6FuGv1s3/assets/platform/content/preview-notification-test-manage-name.png?fit=max&auto=format&n=oLXFxRwf6FuGv1s3&q=85&s=1acfc61a2863fae47b15bee4519b8905" alt="Test Event Name" width="707" height="295" data-path="assets/platform/content/preview-notification-test-manage-name.png" />
    </Frame>
  </Step>
</Steps>

**Related:** [Variables](/platform/content/variables/inserting-variables)

## Creating Test Events From Logs

When you send an event to Courier, that event appears in the [Data Log](/platform/analytics/message-logs). You can convert logged events into test events:

1. Open an event in the Data Log
2. Click **Event Received** in the Timeline
3. Click **Save as Test Event**

The test event will appear in the preview tab of the template it's mapped to.

<Frame caption="Create a Test Event From the Logs">
  <img src="https://mintcdn.com/courier-4f1f25dc/oLXFxRwf6FuGv1s3/assets/platform/content/preview-notification-log-event.png?fit=max&auto=format&n=oLXFxRwf6FuGv1s3&q=85&s=b9a931433afb7781f1b18ea3c0ee44e5" alt="Create a Test Event From the Logs" width="1832" height="1138" data-path="assets/platform/content/preview-notification-log-event.png" />
</Frame>

## Email Preview

Email is the only channel that shows a fully rendered preview as it will appear to recipients. Other channels only display variable validation.

<Frame caption="Preview Your Emails Before Sending">
  <img src="https://mintcdn.com/courier-4f1f25dc/oLXFxRwf6FuGv1s3/assets/platform/content/preview-notification-email.gif?s=c33e4671fd6c31c3bae0b812c6efdaef" alt="Email preview showing rendered template" width="887" height="944" data-path="assets/platform/content/preview-notification-email.gif" />
</Frame>

### Plain Text Preview

Toggle between HTML and plain text versions of your email using the Plain Text Preview switch.

<Frame caption="Plain Text Preview Toggle">
  <img src="https://mintcdn.com/courier-4f1f25dc/oLXFxRwf6FuGv1s3/assets/platform/content/preview-notification-text.png?fit=max&auto=format&n=oLXFxRwf6FuGv1s3&q=85&s=a9692b79059719c47f2030557a99140f" alt="Plain Text Preview Toggle" width="1642" height="772" data-path="assets/platform/content/preview-notification-text.png" />
</Frame>

<Frame caption="Plain Text Preview">
  <img src="https://mintcdn.com/courier-4f1f25dc/oLXFxRwf6FuGv1s3/assets/platform/content/preview-notification-text-preview.png?fit=max&auto=format&n=oLXFxRwf6FuGv1s3&q=85&s=da0328f3c76feb8cc8a15940fbe08fb1" alt="Plain Text Preview" width="1644" height="586" data-path="assets/platform/content/preview-notification-text-preview.png" />
</Frame>

### Sending a Test Email

When previewing an email, you can send a test to yourself or other members of your workspace.

<Frame caption="Send a Test Email">
  <img src="https://mintcdn.com/courier-4f1f25dc/oLXFxRwf6FuGv1s3/assets/platform/content/preview-notification-test-email.png?fit=max&auto=format&n=oLXFxRwf6FuGv1s3&q=85&s=4a0fc2749619edbbd899b209565216cd" alt="Send a Test Email" width="1034" height="646" data-path="assets/platform/content/preview-notification-test-email.png" />
</Frame>

### Preview With Different Brands

If you have multiple [Brand Templates](/platform/content/brands/brands-overview#customizing-brands), you can switch between them in the preview. Otherwise, the preview uses your [Default Brand](/platform/content/brands/brands-overview#the-default-brand).

<Frame caption="Select a Brand to Preview">
  <img src="https://mintcdn.com/courier-4f1f25dc/oLXFxRwf6FuGv1s3/assets/platform/content/preview-notification-test-brand.png?fit=max&auto=format&n=oLXFxRwf6FuGv1s3&q=85&s=cb1fc0928a88b96025c28fb70f015c77" alt="Select a Brand to Preview" width="974" height="606" data-path="assets/platform/content/preview-notification-test-brand.png" />
</Frame>

<Frame caption="Preview Your Email With Your Branding">
  <img src="https://mintcdn.com/courier-4f1f25dc/oLXFxRwf6FuGv1s3/assets/platform/content/preview-notification-brand.gif?s=36050485f7cfbe5e02bf9a647c7eb7ad" alt="Brand preview showing template with custom branding" width="1299" height="757" data-path="assets/platform/content/preview-notification-brand.gif" />
</Frame>

## SMS Preview

<Frame caption="Preview Your SMS Before Sending">
  <img src="https://mintcdn.com/courier-4f1f25dc/oLXFxRwf6FuGv1s3/assets/platform/content/preview-notification-sms.gif?s=15a38cba7643101b9305ce994ffb2a4b" alt="SMS preview showing message content" width="763" height="628" data-path="assets/platform/content/preview-notification-sms.gif" />
</Frame>
