Creating a Content Card

You can create a Content Card using the Braze platform using campaigns and Canvases.

Content Card Creation in Campaigns and Canvases

Build Your Message

Navigate to the Campaign section of the Dashboard and click Create Campaign to open a new messaging wizard for your Content Card. Then, follow the flow of the messaging wizard to quickly create and launch your Content Card.

Create Your Content Card

  1. Name your campaign something clear and meaningful.

  2. Add Teams and Tags, as necessary.

  3. Add and name as many Variants as you need for this campaign.
    • You can choose different platforms, message types, and layouts for each of your added Variants.

Setup Your Canvas

Navigate to the Canvas Section of the Dashboard and click Create Canvas to open the Canvas Wizard to begin setting up your Canvas. Then, follow the flow of the Canvas wizard to quickly create and launch your Content Card.

  1. Name your Canvas something clear and meaningful.

  2. Add Teams and Tags, as necessary.

  3. Define your conversion events - Canvas supports up to 4 conversion events. These events must be assigned during Canvas creation and cannot be changed once a Canvas has launched.

  4. Set up your Entry Schedule - Canvas offers Scheduled, Action-Based and API-Triggered entry.

  5. Select your Entry Audience - Here, you can determine who will enter this Canvas and target users by segments and filters; these conditions will not be re-evaluated at each step. Within this dialogue, you also have the option to select Entry Controls, such as allowing users to re-enter this Canvas and set an entry limit. You’ll also automatically be given a snapshot of what that approximate target population looks like right now.

  6. Set your Send Settings - Here, you can set messages sending options for all steps within Canvas. Some of these options include setting subscription settings, adjusting the rate limit, toggle frequency capping, and more.

  7. Add a Step in the Canvas Builder - Within this step, click Messages and then select the Content Card Messaging Channel. Here you will create and configure your Content Card.
    Create Your Content Card

For more in-depth details on setting up and configuring your Canvas, check out our Canvas documentation.

Step 1: Specify Your Message Types

Message Types

Learn more about the expected behavior and look of each of these messages on our Creative Details page, or by clicking on the linked message types in the tables.

These Content Card types are accepted by both mobile apps and web applications.

Message Type Type Description
Classic This Card has a simple layout with a bolded title, message text, and an optional image that sits to the left of the title and text. It is best to use a square image or icon with the Classic Card.
Captioned Image This Card allows you to showcase your content with copy and an attention-grabbing image!
Banner The Banner Card allows you to get creative and command attention with space for images, gifs, and other non-text based content.

Step 2: Compose a Content Card

The Compose tab in the Campaign Wizard (located in the step wizard in Canvas) allows you to edit all aspects of your message’s content and behavior.

Compose Content Card

The content here varies based on the Message Type chosen in the last step but may include any of the options below:

Content Options Description
Language See our full list of available languages. Click Add Languages and select your desired languages from the provided list. This will insert Liquid into your message. We recommend selecting your languages before writing your content so you can fill in your text where it belongs in the Liquid.
Image Click Add Image or use an image URL. Where applicable, click Include Image or Upload Image and follow the presented instructions. Each message type and platform may have its own suggested proportions and requirements - be sure to check what those are before commissioning or making an image from scratch!

Content Card message fields are limited to 2kb in total size, as noted in the section below.
Pinning A pinned card will display at the top of a user’s feed and cannot be dismissed by the user. If more than one card in a user’s feed is pinned, the pinned cards will display in chronological order. Once a card has been sent, you can not update its pinned option retroactively. Changing this option after a campaign has been sent will only affect future sends.
Expiration Set the specific expiration date or the days until a Card expires. Currently, Braze supports a maximum expiration time of 30 days.

All variants have identical expiration dates.
On Click Behavior For either Android, iOS, or Web:
Redirect to Web URL, Deep Link into App or None.
When your customer clicks on a presented link in the card, your link can either lead them deeper into your app or to another site.
Title & Message Text We recommend clear and concise titles and message content. Write anything you want. There are no limits, but the faster you can get your message across and get your customer clicking - the better!

Step 3: Configure Additional Settings

Add key-value pairs to your message, if needed.

You can use key-value pairs to create categories for your Cards, create multiple Content Card Feeds (Android, Web, iOS, and customize how Cards are sorted.

Step 4: Build the Remainder of Your Campaign or Canvas.

Build the remainder of your campaign; see the sections below for further details on how to best utilize our tools to build Content Cards.

Choose Delivery Schedule or Trigger

  • Content Cards can be delivered based on a scheduled time, an action, or based on an API trigger.
  • You can also set the campaign’s duration and Quiet Hours in this step.
  • Frequency Capping does not apply to Content Cards.

Choose Target Segment

  • Next, you need to choose the target segment from the dropdown menu.
  • You’ll automatically be given a snapshot of what that approximate segment population looks like right now.
  • Keep in mind that exact segment membership is always calculated just before the message is sent.

Choose Conversion Events

  • Braze allows you to track how often users perform specific actions (i.e., conversion events) after receiving a campaign.
  • You have the option of allowing up to a 30-day window during which a conversion will be counted if the user takes the specified action.

After you’ve finished building the last of your campaign, review its details, test it, then send it!

Complete the remaining sections of your Canvas step; see the sections below for further details on how to best utilize our tools to build Content Cards. After you have created and configured your step, check out our Canvas Documentation for further details on how build out the rest of your Canvas, implement multivariate testing and Intelligent selection, and more.

Choose Step Schedule

  • Content Cards can be delivered based on a scheduled time or Action in Canvas

Choose Audience

  • Next, you need to adjust Audience Options for this step. Here, you can further refine the recipients of this step by specifying segments and adding additional filters. Audience options will be checked after the delay, at the time messages are sent.

Choose Advancement Behavior

  • Lastly, select your Advancement behavior for this step. Here you can choose to either “Advance when Message Sent” that advances your users to the next steps when the Content Card is sent, or “Immediately Advance Audience” that advances users when either the Content Card is sent, or the Content Card was not sent because it got aborted.
  • To read more about Canvas Advancement Behavior, check out of Canvas Documentation.

After you’ve finished building out your Canvas Step, review its details and test it!

Things to Know

Capabilities Not Yet Supported

The following capabilities are not yet supported for Content Cards:

  • Vouchers
  • Frequency Capping
  • Re-ordering Content Cards from the Braze UI
  • Post-launch Edits

Sending Behavior

Once Content Cards have been sent, similar to emails, they sit waiting in an “inbox” ready to be delivered to the user. Once content is pulled into the Content Card (at time of displaying), the content cannot be changed during its lifespan. This applies even if you are calling an API through Connected Content, and the data from the endpoint changes; this data will not get updated. It can only be stopped from sending to new users and removed from users’ feeds. If you modify a campaign, only future cards that are sent will have the update.

If you need to remove old cards, you must stop the campaign to do so. This can be done by navigating to your Content Card campaign and selecting Stop Campaign. Stopping the campaign brings up the prompt shown below. If you would like to remove Content Cards, check the box to remove any cards that have been sent. This will cause the card to be hidden by the SDK on the next sync.

Content Card

Card Removal Events

Some Content Cards are only relevant up until a user performs some action. For example, a card nudging users to activate their account shouldn’t be shown once the user completes that onboarding task.

Within a campaign or Canvas Message, you can optionally add a Removal Event to specify which custom events or purchases should cause previously sent cards to be removed from that user’s feed; triggered via SDK or REST API.

Content Card Removal Event

Updating Already Sent Cards

If you find you need to make changes to cards that have already been sent:

  1. Stop your campaign
  2. Remove active Content Cards from users’ feeds
  3. Edit your campaign as needed
  4. Restart your campaign
New Stuff!