Developer Announcements

dennisedson
HubSpot Product Team
HubSpot Product Team

Upcoming Sunset of Legacy Stage Calculated Properties for Contacts and Deals

We have introduced a new set of pipeline stage calculated properties for the contacts and deals objects that offer more functionality than their predecessors.  With the introduction of these new properties, we will be sunsetting the corresponding legacy properties.  These properties will cease to be available or function on November 20, 2024.  

What’s changing

We have added new stage calculated properties for contacts and deals which are available today. These properties include the following.

  • hs_v2_date_entered_{stage_id}
  • hs_v2_date_exited_{stage_id}
  • hs_v2_latest_time_in_{stage_id}
  • Hs_v2_cumulative_time_in_{stage_id}

Note: the {stage_id} value in the property names above may exactly match the stage ID on the pipeline stage, or it may be altered slightly to conform to property naming rules.  For example, a hyphen in the ID of a pipeline stage may be substituted with an underscore in the corresponding property name.

With the availability of these new properties, we will be sunsetting the following legacy versions which include the following.

  • hs_lifecyclestage_{stage id}
  • hs_date_entered_{stage id}
  • hs_date_exited_{stage id}
  • hs_time_in_{stage id}
The legacy properties do behave differently than the new, improved properties and may result in different values. Some key differences:
  • legacy properties clear data when an object moves backwards.
  • legacy properties auto-populate data when an object skips stages.
When switching over from the legacy properties to the new properties, there may well be some differences in values based on the above. It's important to remember that the data of the new properties provide higher data accuracy than the legacy ones.
 

What do you need to do

There is no need to merge the new data with the old. Integrations only need to switch over to the new v2 properties. The new properties were backfilled and should offer historical values.

Now that there is a replacement set of properties for the legacy properties, integrators will need to migrate to the new v2 properties by November 20th, 2024.

 

When is this happening

The new properties are available now.  The legacy properties will stop being returned for any API request beginning on November 20th, 2024.  

 

11 Replies 11
NHeidl
Participant

Upcoming Sunset of Legacy Stage Calculated Properties for Contacts and Deals

I would have thought you would spend sometime at least making HS far more flexible.  For example, I cannot remove or move Email when I create a new contact.  This is infuriating.  I can't adjust the column headers to text wrap so I can see more of the data across the screen.  Another is the search only allows for name, email, phone and company.  I would like to see option for one colum of choice or be able to select how the search works.  Another is the inability to select two owners via inputting contact owner.  

0 Upvotes
NHeidl
Participant

Upcoming Sunset of Legacy Stage Calculated Properties for Contacts and Deals

I have no clue what this all means.  No examples, no detailed explanation at all.  How about you provide some semblance of a simple explanation for the layman?

MShandor
Member

Upcoming Sunset of Legacy Stage Calculated Properties for Contacts and Deals

Please go back in the thread, I posted 2 weeks ago a more "layman" explaination that might be helpful.

0 Upvotes
fionabOS
Participant

Upcoming Sunset of Legacy Stage Calculated Properties for Contacts and Deals

Hello,

If we are using the legacy contact properties in some workfows, lists, and/or reports, do we need to switch the legacy properties to the new ones before November 20th so that our workflows keep working normally after the old properties are sunseted? Or will the switch be done automatically ?

If not, is there an easy way to do this?

0 Upvotes
dennisedson
HubSpot Product Team
HubSpot Product Team

Upcoming Sunset of Legacy Stage Calculated Properties for Contacts and Deals

@fionabOS ,

We will handle the migration for the items you mentioned (lists, workflows, reports).

Necessary changes are only applicable to 3rd party integrations and their usage.

Xiawanbai
Contributor

Upcoming Sunset of Legacy Stage Calculated Properties for Contacts and Deals

Hi, thank you both for the information. Can anything go wrong? If you are using it, did you find anything that was uncorrect compare to the previous data you had in the fields?

0 Upvotes
websrey
Participant

Upcoming Sunset of Legacy Stage Calculated Properties for Contacts and Deals

Greetings,

 

Nothing seems to go wrong here, the data will be same as it was, jut it will migrated to new property, from "Became a [lifecycle stage] date" to "Date entered[lifecycle stage]".

I have opted in, and everythings working fine, as it was earlier.

If you are still not sure you can otp out from this migration by clicking here in this popup shown below, that you'll get by clicking on "Learn more".

 

legacy contact.JPG

0 Upvotes
Xiawanbai
Contributor

Upcoming Sunset of Legacy Stage Calculated Properties for Contacts and Deals

Hi, can anyone please explain a bit more clear what do we need to do and how it might / will affect users of Hubspot? 

websrey
Participant

Upcoming Sunset of Legacy Stage Calculated Properties for Contacts and Deals

Greetings,

 

Nothing to worry about it.

 

HubSpot have added new calculated properties for lifecycle stages, and the already existing proeprty which is called leagacy contact properties, will see the sunset.

 

The data will not be lost.

 

If you don't want the migration then you have the option to opt out, that you can do by clicking here in this popup shown below, that you'll get by clicking on "Learn more".

legacy contact.JPG

 

But if you want to opt in then you just have to click "Accept" button, and you'll see that new calculated properties in your HubSpot and all the data will be migrated to these new ones.

 

0 Upvotes
MShandor
Member

Upcoming Sunset of Legacy Stage Calculated Properties for Contacts and Deals

One thing to note is your level of membership with Hubspot.  If you look under Data Management-Custom Events and you see an orange arrow (image below).  You don't currently have Marketing Hub Enterprise; therefore the change will likely not have as big or an impact on your account.

MShandor_0-1724359603109.png

 

What makes the update look more confusing is that it is written it in code versus using the names of the fields that will change. 

 

The fields that will be changed are the following:

Lifecycle Stage

Date Entered

Date Exited

Time In

(We chose to create custom fields because Lifecycle stage did not meet the needs of our company so the change will not impact us)

 

If you do use those fields above, you have 2 options:

1.  Reject/decline the change

2.  Accept the change and use the new fields (see list below)

 

Date Entered

Date Exited

Latest Time in

Cummulative Time in

 

As with any CRM it comes down to how you use it at your company.  If you have Marketing Hub Enterprise you have 24/7 customer service by email or phone so I would recommend that if you have concerns you have someone walk you through everything and ask all the questions you have about the developer changes.  If you do not have customer service included with your membership, I would analyze how your team uses the fields above and make a determination that works best for you.

 

Hope this helps.

 

 

dennisedson
HubSpot Product Team
HubSpot Product Team

Upcoming Sunset of Legacy Stage Calculated Properties for Contacts and Deals

@Xiawanbai , if you have an integration that is using the legacy versions of the properties listed above, you will need to replace those properties with the newer version.  Those properties are available now and should have values associated with them so it should be a pretty straight forward process.