Skip to content

User Update

The User Update component allows you to update a user’s attributes, events, and purchases in a JSON composer, so there’s no need to include sensitive information like API keys.

With User Update, updates don’t count towards your users or track per minute rate limit. Instead, these updates are batched so Braze can process them more efficiently than a Braze-to-Braze webhook. Note that this component does consume data points.

Users will only advance to downstream Canvas steps after the relevant user updates have been completed. If your downstream messaging relies on the user updates that you’re making, you can ensure that these updates have been completed prior to when the messages send.

Create a User Update

Drag and drop the component from the sidebar, or click the plus button at the bottom of the variant or step and select User Update.

There are three options that allow you to update existing, add new, or remove user profile information. All combined, the User Update steps in an app group can update up to 200,000 user profiles per minute.

Update custom attribute

To add or update a custom attribute, select an attribute name from your list of attributes and enter the key value.

Remove custom attribute

To remove a custom attribute, select an attribute name using the dropdown. You can switch to the advanced JSON composer to further edit.

Advanced JSON composer

Add an attribute, event, or purchase JSON object up to 65,536 characters to the JSON composer. A user’s global subscription and subscription group state can also be set.

Using the advanced composer, you can also preview and test that the user profile is updated with the changes with the Preview and test tab. You can either select a random user or search for a specific user. Then, after sending a test to a user, view the user profile using the generated link.


Do not include any of the following information in the JSON composer:

  • External user ID
  • API key
  • Braze cluster URL
  • Fields related to push token imports

Use case

For example, if we want a group of users to be promoted to loyalty members, select Loyalty Member as the attribute name, and select True as the corresponding key value. So, the users who enter this User Update step will have their VIP Member attribute updated to True.

Personalization features

To store the property of the trigger event for a Canvas as an attribute, use the personalization modal to extract and store the Canvas entry property. This component also supports the following personalization features:

New Stuff!