Skip to content


Braze admins can group their dashboard users into teams with varying user roles and permissions.

Teams can be set up across customer base location, language, and custom attributes so that team members and non-team members have different access to messaging features and customer data. Team filters and tags can be assigned across various engagement tools.

Teams are not available on all Braze contracts. If you’d like to access this feature, reach out to your Braze account manager or contact us for a consultation.

Creating teams

Go to Settings > Internal Teams and click Add Team.

Adding a new team

Enter the Team Name. If desired, use the Define Team field to select a custom attribute, location, or language to further define what user data that team has access to. For example, a possible use case is to perform testing with teams by creating a development team that only has access to test users, identified by a custom attribute.

If a team is defined by a custom attribute, language, or country, you can then use the team to filter end-users for features like campaigns, Canvases, Content Cards, segments, and more. For more, see Assigning team tags.

Assigning users to teams

Braze administrators and limited users with the company-level permission “Can Manage Company Settings” can assign team-level permissions to a dashboard user with limited access. When assigned to a team, dashboard users are limited to only read or write data available to their particular teams, such as user language, location, or custom attribute, as defined when the team was created.

To assign a user to a team, navigate to Settings > Company Users and select a user you’d like to add to your team.

Then perform the following steps:

  1. Click Edit.
  2. Set their User Role to Limited.
  3. Add them to the appropriate workspace.
  4. Select the Team you’d like to add this user to, and assign specific permissions from the Team permissions column.

Available team-level permissions

The following are all available permissions you can assign at the team level. Any permissions not listed here are only granted on the workspace level, and these permissions will appear as “–” in the Teams permissions column.

  • Access Campaigns, Canvases, Cards, Content Blocks, Feature Flags, Segments, Media Library, and Preference Centers
  • Send Campaigns, Canvases
  • Publish Cards
  • Edit Segments
  • Export User Data
  • View User Profiles PII Compliant
  • Manage Dashboard Users
  • Manage Media Library Assets

To see descriptions of what each user permission includes and how to use them, check out our User Permissions section.

Assigning team tags

You can assign a team to Canvases, campaigns, cards, segments, email templates, and media library assets with the Add Team filter.

Adding a Team tag to a campaign

  • Based on the definitions applied when the team was created, when a team filter is assigned, that engagement tool’s audience is restricted to user profiles that match the definition.
  • Based on assigned permissions, team members will only be allowed to access dashboard engagement tools that have their team filter set. If they have limited or no workspace permissions, they must add a team filter to certain objects before they can save or launch them. Team members are also able to filter Canvases, campaigns, cards, and segments by team to identify content relevant to them.

Use cases

Consider the following two scenarios for a marketer in Braze named Michelle. Michelle is a member of a team called “Development”. She has access to all of the team-level permissions for the Development team.

In this scenario, Michelle is a limited user that has no workspace-level permissions. Her permissions look something like this:

Based on Michelle’s assigned permissions, whenever she creates a campaign, she can only assign the “Development” team to that campaign. She can’t launch the campaign unless the team is assigned, and she can’t view or access any other team tags.

In this scenario, Michelle is still a member of the Development team, but she also has an additional workspace-level permission.

Because Michelle has the workspace-level permission of “Access Campaigns, Canvases, Cards, Content Blocks, Feature Flags, Segments, Media Library, and Preference Centers”, she can view and assign other team filters to the campaign she creates.

Similar to the first scenario, Michelle must add the Development team tag to the campaign before she can launch it.

Testing with teams

One possible use case for teams is to create a teams-based approval system for testing and launching content in a production environment.

To do so, create a “Development” team that only has access to test users. You can limit a team to only access test users if your test users are identifiable by a custom attribute. Then, add the custom attribute as a definition when creating or editing the team (see the preceding section Creating teams). Your approvers should have access to all users.

The general process would be as follows:

  1. Development team creates a campaign and adds the “Development” team tag.
  2. Development team launches the campaign to test users.
  3. Approver team validates the local campaign design, promotes, and launches. To launch, the Approver team changes the team tag from “Development” to “[All Teams]” and relaunches the campaign.

For changes to active campaigns:

  1. Development team clones the running campaign, adds the “Development” team tag, and saves.
  2. Development team makes edits and shares with the Approver team.
  3. Approver team removes the “Development” team tag, pauses the previous campaign, and launches the new campaign.

Archiving an existing Team

You can archive teams from the Internal Teams page.

Select one or many teams to archive. If the team is not associated with any object within Braze, the team will be archived immediately. If the team is associated with an object, you will be presented with an option to remove the team after the archive process or replace the team.

Archiving a Team that is associated with an object in Braze

Braze admins can unarchive a Team by selecting the archived Team and clicking Unarchive.

New Stuff!