How to use Bucket Number in Property Transformer
The Bucket Number action lets you assign numbers to labeled buckets based on configurable ranges. This is useful for segmenting deals by size, bucketing lead scores for prioritization, or grouping any numeric value into categories.
This action works on all object types including Contacts, Companies, Deals, and Custom Objects.
Supported property types:
- Number
How to set it up
1. In your HubSpot workflow, add a new action
2. Under "Integrated Apps", find "Brave Tools"
3. Select "Bucket Number"
4. Configure the input fields (see below)
5. Map the output values to the properties you want to update
Input fields
Source number (required)
The number property to bucket. Select any number property from the enrolled object (e.g. deal amount, lead score, revenue).
Bucket configuration (required)
Define your ranges and labels. Use this format: "min-max:Label" separated by commas.
Examples:
-
"0-999:Small,1000-9999:Medium,10000+:Large"
-
"0-4999:Starter,5000-24999:Growth,25000+:Enterprise"
-
"0-49:Cold,50-79:Warm,80-100:Hot"
Use "+" after a number to indicate "and above" (e.g. "10000+:Large").
No match label
The label to use when the number doesn't fall into any defined range. Defaults to "Unknown".
Output fields
Bucket label - The matching range label, e.g. "Growth".
Bucket index - The index of the matching range (0-based), e.g. 1 for the second range.
Example
You want to segment deals by size.
Configuration: Bucket configuration = "0-4999:Starter,5000-24999:Growth,25000+:Enterprise"
Input: Deal amount = 12000
Output: Bucket label = "Growth", Bucket index = 1
Good to know
-
The bucket index is useful for sorting or further workflow logic.
-
If the number field is empty, the output fields will be left empty and the workflow will continue.
-
If the number doesn't match any range and no "No match label" is set, the label will be "Unknown".
-
Property Transformer is available on paid plans. Trial users do not have access to this feature.