Enabling and syncing badge labels in App Security
After publishing labels in Google Admin Console, enable and sync them in App Security.
Steps
- In App Security, navigate to Protect > Policies > Google Workspace > setup API.
- Scroll to the Google Badge Labels section.
-
Select the Enable Labels checkbox.

-
Confirm the Fields and Options table lists the label fields and options published in Google Admin Console:
Table 1. Column Description Fields The label field name as configured in Google Admin Console. Options The label options for that field. -
Click Sync Changes to pull the latest label configuration from Google. The last save time updates to confirm the sync was successful. Click
"+" on the right side of the table to select and add the synced label fields. Now the new labels appear on the list.
Note: If new labels have been published in Google Admin Console after the last sync, a New Fields Available notification appears next to the Sync Changes button. Click Sync Changes to update the fields and options table before configuring policies. - Click Save.
-
If a label has been deleted in Google Admin Console, click "−" next to the label row to remove it from App Security.
Note: A label must be deleted from Google Admin Console before it can be permanently removed from App Security. Clicking sync changes alone does not remove the label from the table, you must also click "−" to confirm removal.
Once Badge Labels are enabled, configure policies to enforce actions based on label events, see the Configuring API Google Labels policies.