Retention Limit for Field History Data Is Now Enforced

Salesforce guarantees to retain your field history data for up to 18 months through your org, and up to 24 months via the API. To ensure high availability of data and accommodate the fast-growing data needs of our customers, up until now, we haven’t enforced the 18-month retention policy. Starting with Winter ’19, you can access data older than 18 months only in a limited fashion via Data Loader or the API. In Spring ’19, you can access field history data up to 24 months old via Data Loader or the API, but we begin the process of removing field history data older than 24 months.
Where: This policy applies to all orgs created after June 1, 2011 who have not purchased the FAT add-on.


If your org was created before June 1, 2011, Salesforce commits to retain your field history beyond the 18-month limit.

How: To guarantee that you can access your field history data, purchase the FAT add-on. FAT lets you define a policy to retain archived field history data up to 10 years from the time the data was archived. After Winter ’19, you have a few months grace period to either purchase FAT or create your own back-up plan. The grace period ends with Spring ’19. Because of the rolling nature of mass deletes, the data may still be available for some time after Spring ’19. However, you should use this date as a deadline in your planning. To purchase FAT, contact Salesforce Customer Support.

  • During the grace period, use Data Loader or the queryAll() API to retrieve old field history.
  • Once field history data reaches the 18-month limit, Salesforce retains it for 6 more months, but the data is accessible only via Data Loader or the API. This 6-month extended period is ongoing behavior, even after Spring ’19. Once Salesforce deletes data, you can’t use the getDeleted() API to retrieve it.
  • If you need help retrieving your field history before it’s deleted, contact Salesforce Customer Support.