How Does Setting a Lock Date Affect Data Processing?

Last updated: November 19, 2026

When you make a change to a metric's configuration, such as the filters used or who receives credit, Ambition will ask you to set a Lock Date before saving your changes. Setting a Lock Date means that the new metric configuration will not be applied to any data dated prior to the Lock Date.

Required permissions:

  • The Metrics: Edit or Integrations: Edit permission is required to edit a metric and set its lock date.

What Happens to Data Dated Before the Lock Date

For the data impacts discussed below, we'll use the following scenario as an example:

  • January 1: You created a Closed Won Deals metric. The metric only counts opportunities where the status field is Closed Won.

  • November 1: You edited the metric. It now counts an opportunity where the status is Closed Won, Closed Won - Signed, Closed Won - Opportunity Converted.

  • You set the metric lock date to be August 1.

Already Counted Values Will Not Be Changed

If your integration sends an updated record that has a date prior to the lock date, Ambition will ignore the update. A user's total for that day and metric will not be updated.

Example

For example, assume that Jane Doe received credit for a Closed Won Deal on March 31.

Since your metric's lock date is August 1, Jane Doe's March 31 deal will not be recounted using the new metric logic.

If your integration sends an updated record for Jane's March 31 opportunity which changes the deal value, that change will not be reflected in Ambition. Jane's March 31 deal value will remain as whatever it was prior to the Lock Date being set.

New Historical Records Will Not be Counted

If your integration sends historical data dated prior to the Lock Date and those records did not appear in Ambition previously, Ambition will not process those records or attribute them to a user. The records will be discarded.

Example

Your team decides that you want to bring in historical data for the past 365 days. Since your Closed Won Deal metric has a Lock Date of August 1, however, you can only bring in data fro August 1 onwards. Any data dated prior to August 1 will be discarded.

What Happens to Data Dated on or After the Lock Date

Ambition will recalculate historical data dated after the Lock Date using the new metric setup. Any incoming future data will also use the new metric configuration.

Example

Jane had several Closed Won deals where the status was either Closed Won - Signed or Closed Won - Opportunity Converted.

Since these statuses were not accepted as part of the original metric configuration, Jane didn't receive credit for them.

With the November 1 metric update and August 1 as the Lock Date, Ambition will reprocess Jane's August 1 - present records using the new metric design. Jane will receive credit for records she did not previously receive credit for, as long as they meet the metric logic.

Note:

  • Lock Dates cannot be set to the future. Lock Dates can also not be set any earlier than the existing Lock Date.


Related Articles