Skip to content
Check out our new developer portal and join the Braze developer community!

Sending test messages

This reference article goes over how to send test messages across the different Braze channels and how to incorporate custom event properties and user attributes.

Before sending out a messaging campaign to your users, as a best practice, we recommend testing it to make sure it looks right and operates in the intended manner. You can create and send test messages to select devices or team members using the tools in the dashboard.

Channel-specific test sending

For steps to send test messages, refer to the following section for your channel.

Mobile push

After drafting your mobile push, select the Settings tab and add your email address or user ID in the Add Individual Users field. When you’re ready, click Send Test to send your drafted message to your device.

Test push

Web push

After creating your web push, select the Settings tab. Check Send Test to Myself and click Send Test.

Test web push

If you have already accepted push messages from the Braze dashboard, you will see the push come through in the corner of your screen. Otherwise, click Allow when prompted, and the message will appear.

In-app message

If you have push notifications set up within your app and on your test device, you can send test in-app messages to your app to see what it looks like in real-time. After drafting your in-app message, select the Test tab and add your email address or user ID to the Add Individual Users field. When you’re ready, click Send Test. A test push message will appear at the top of your device screen.

Test In App

Directly clicking and opening the push message will send you to your app, where you’ll be able to view your in-app message test.

Content card

After creating your Content Card, you can send a test Content Card to your app to see what it will look like in real-time. After drafting your Content Card, select the Test tab and select at least one Content Test Group or individual user to receive this test message.

Test Content Card


After creating your SMS/MMS message, you can send a test message to your phone to see what it will look like in real-time. After drafting your message, select the Test tab and select at least one Content Test Group or individual user to receive this test message.

Test Content Card


After creating your webhook, you can do a test send to check the webhook response. Select the test tab and select send test to send a test send to the supplied webhook URL. You may also select an individual user to preview the response as a specific user.

Test Content Card

News Feed card

Sending a test News Feed card requires you to set up a test segment and subsequently send a test campaign out.

Step 1: Create a designated test segment

Once you set up a test segment, you can utilize these messaging channels. The process takes a few short steps and, if configured properly, will only need to be done once.

Go to the Segments page and create a new segment. In the dropdown menu under Add Filter, locate the testing filters at the bottom of the list.

Testing Filters

Use these testing filters to select users with specific email addresses or external user IDs.

Testing Filter Options

These filters have the following options:

  1. Equals - Looks for an exact match of the email or user ID you provide. Use this if you only want to send the test campaigns to devices associated with a single email or user ID.
  2. Does not equal - Use this if you want to exclude a particular email or user ID from test campaigns.
  3. Matches - Finds users that have email addresses or user IDs that match part of the search term you provide. You could use this to find only the users with an “” address, allowing you to send messages to everyone on your team.

These filters can also be used in conjunction to narrow down your list of test users. For example, the test segment could include an email address filter that matches “” and another filter that does not equal[email protected]”. You can also select multiple specific emails by using the matches option and separating the email addresses with a “|” character (e.g., matches[email protected]|[email protected]”).

After adding the testing filters to your test segment, verify that you’ve selected only the users you intended by clicking Preview at the top of the segment editor or by exporting that segment’s user data to CSV. To export segment user data, click the User Data dropdown and select CSV Export All User Data.

Verify Test Segment

Exporting the segment’s User Data to CSV will give you the most accurate picture of who falls under that segment. The Preview tab is only a sample of users in the segment and therefore may appear to have not selected all intended members. For more information, check out [Viewing and Understanding Segment Data][7].

Once you’ve confirmed that you’re only targeting the users you want to receive the test message, you can either select this segment in an existing campaign that you want to test or click the Start Campaign button in the segment menu.

Step 2: Send a test campaign

To send test News Feed cards, you need to target your previously created test segment. Begin by creating a multichannel campaign and following the usual steps. When you reach the Target Users step, select your test segment as shown in the following image.

Test Segment

Finish confirming your campaign and launch it to test your News Feed cards.

Be sure to check the box titled “Allow users to become re-eligible to receive campaign” under the Schedule portion of the campaign wizard if you intend to use a single campaign to send a test message to yourself more than once.

Campaign personalized with user attributes

If you are using personalization in your message, you’ll need to take additional steps to properly preview your campaign and check that user data is properly populating the content.

When sending a test message, make sure to choose either the option to Select Existing User or preview as a Custom User.

Testing a personalized message

If selecting an existing user, enter a specific app user’s user ID or email in the search field. Then use the dashboard preview to see how your message would appear to that user, and send a test message to your device that reflects what that user would see.

Select a user

If previewing as a customized user, enter text for various fields available for personalization, such as the user’s first name and any custom attributes. Once again, you can enter your own email address to send a test to your device.

Custom user

Campaign personalized with custom event properties

Testing campaigns personalized with custom event properties differs slightly from testing other types of campaigns outlined. The most robust way to test campaigns personalized using custom event properties is to trigger the campaign yourself. Begin by writing up the copy involving the event property:

Composing Test Message with Properties

Then use action-based delivery to deliver the campaign when the event occurs.

Test Message Delivery

Target the users as you would for testing using either a testing filter or by targeting your own email address and finish creating the campaign.

Test Message Targeting

Go into your app and complete the custom event, and the campaign will trigger, and you should see the message customized with the event property:

Test Message Example

Alternatively, if you are saving custom user IDs, you can also test the campaign by sending a customized test message to yourself. After writing the copy for your campaign, select the Test tab and choose Customized User. Add the custom event property on the bottom of the page, add your user ID or email address to the top box, and click Send Test.

You should receive a message personalized with the property.

Testing Using Customized User

New Stuff!