To prioritize the contacts and companies in your CRM, you can build custom lead scores based on contact or company actions or properties. By assigning scores to leads, you can determine which contacts or companies are likely to become customers. Lead scores evaluate records based on criteria and assign values to corresponding properties. Score properties can also be used in HubSpot tools like lists, workflows, and reports.
This article explains how scores are calculated, how to customize and analyze them, and what kinds of scores you can create.
Please note: on August 31, 2025, score properties will be sunset and replaced by new scoring tools.
Types of scores
You can create the following types of lead scores for contacts and companies:
How scores are calculated
You can set criteria for event and property rules in score groups to determine scores. Scores must have at least one group, but you can include multiple groups that add up to the total. It is possible to set a limit for the maximum total score, as well as a limit for maximum scores for each group of criteria or events. For example, you could limit points for a group of awareness events, such as page visits, and allow more points for a group of conversion events, such as sales form submissions and meetings.
To better understand the different score limits and values:
For example, in the following contact engagement score:
Positive and negative points
For each rule, you can choose to add or subtract points. For example:
Score decay
For engagement or combined score event groups, you can turn on score decay, which automatically reduces an individual event's score based on how long ago a scored event occurred. Each event's score decay follows linear logic, and decayed scores total the overall score value.
As an example, a rule gives 10 points when a certain form is filled out. A decay of 50% every month would mean that, a month after the form was filled out, the 10 points from that event would be cut in half, and it would contribute 5 points. The decay is based on the original event score value (i.e. 10 points). In this example, another month later, the form submission contributes 0 points to the score.
Score decay also applies to historical data. For example, if a rule adds 2 points for a CTA click with 100% decay in 3 months, if the CTA click happened 4 months ago, the contact won't get 2 points.
AI Scores (Marketing Hub Enterprise only)
Using AI, you can create engagement and fit scores for contacts. Your contacts are evaluated to train an AI model, and a score is built with recommendations based on the evaluated contacts. A minimum sample size of 50 contacts, containing 25 converted and 25 non-converted, is required to generate a score.
For example, if you set Start: Marketing Qualified Lead, End: Sales Qualified Lead, Timeframe: 30 days, the AI will identify commonalities among contacts who transitioned from Marketing Qualified Lead to Sales Qualified Lead in the past 30 days and generate a score with criteria based on the insights.
Score inclusion and exclusion lists
When you create a score, you can select which records should or should not be scored. When setting up a score, on the Contacts or Companies tab:
Learn more about selecting which records to score in engagement scores, fit scores, or combined scores.
Score properties
When you build a score, a corresponding score property is created that stores the contact and company values for that score. As soon as a score is enabled, the contacts and companies will be evaluated retroactively and the score property value will be set. The property will update continuously when a contact or company meets any of the score criteria.
During the score set up, you can customize the name of the property and how it's organized in your contact and company property groups. For combined scores (Enterprise only), three properties are created: A total score that stores engagement and fit points together, an engagement score that stores only engagement points, and a fit score that stores only fit points.
For example, your business sells two different services, with different engagement criteria to help decide whether a contact is a good lead. You may want to create separate engagement scores for each. In this case, you'd have two separate properties that you can use track the scores on records or in filters of views, lists, workflows, or reports.
Score thresholds
For each score, you can set up score thresholds to categorize records based on their score values. For each score range, a threshold property with color-coded labels is created so that you can quickly identify good leads.
What happens when a score is turned on or updated
Turning on a score
Scores are first assigned retroactively based on contacts and companies' current and historical property values or actions. Moving forward, contacts' and companies' values for the score property will be continuously updated based on changes to their property values and actions.
Test records before turning on a score or preview the score distribution to make sure it assigns points correctly.
Updating a score
After you update a score, all contact and company property values and actions are re-evaluated based on the changes you've made to the score.
If you're using the score in other tools (e.g., views, lists, workflows, reports, etc.) they may be impacted if the changes you've made affect the criteria set in these tools. To verify and update where the score property is used:
Use lead scores in HubSpot tools
As soon as you've enabled scores, you can use the score properties in other tools to identify, segment, and report on your leads. You might, for instance:
Create a workflow to automatically assign an owner to unworked contacts with a score over 50.
Create a workflow to send a notification to the record owner when a company's score goes above 75.
Score history and performance
For instructions on how to build each type of score, refer to these articles: