Custom Event and Attribute Management

Adding Custom Attributes, Custom Events, and Products

You can manage custom attributes, custom events (and their properties), and products (and their properties) from the respective tabs on Manage Settings page:

  • Custom Attributes
  • Custom Events
  • Products

To add a custom attribute, event, or product, go to the respective tab and click + Add. Give it a name (and for custom attributes, a data type) and click Save. This will enable tracking on it.


Managing Properties

Once you have created a Custom Event or Product, you can click Manage Properties for that event or product to add new properties, blocklist existing properties, and view which campaigns or Canvases use this property in a trigger event.



To make these added custom attributes, events, products, or event properties trackable, you must ask your developer to create it in the SDK using the exact name you used to add it earlier. Or, you can use Braze’s APIs to import data on that attribute. After that, the custom attribute, event, or other will be actionable and apply to your users!

Blocklisting Custom Attributes, Custom Events, and Products

If you want to stop tracking a specific custom attribute, event, or product (e.g., accidental creation during testing, no longer useful), search for it in the Custom Events tab, then click Blocklist.

To prevent collecting certain device attributes, see our SDK guide.

Once a custom event or attribute is blocklisted:

  • No data will be collected regarding that event/attribute,
  • Existing data will not be wiped,
  • Blocklisted events and attributes will not show up in filters or graphs.

Changes to the blocklist may take a few minutes to propagate. You may re-enable any blocklist event or attribute at anytime.

Forcing Data Type Comparisons

Braze automatically recognizes data types for attribute data that is sent to us. However, in the event multiple data types are applied to a single attribute, you can force the data type of any attribute to let us know what it really is. Click on the drop-down in the Data Type column to choose.


Data Type Coercion

Forced Data Type Description
Boolean Inputs of 1, true, t (not case sensitive) will be stored as true
Boolean Inputs of 0, false, f (not case sensitive) will be stored as false
Number Integers or Floats (i.e. 1, 1.5) will be stored as numbers

For more information on specific filter options exposed by different data type comparisons check out Configuring Reporting. And for more information on the different available data types, refer to Custom Attribute Data Types.

New Stuff!