Skip to content
← Back to Changelog

Thursday, February 1st 2024

Legacy environment variable secrets are being sunset

Posted by

Avatar for anatrajkovska

Ana Jovanova

Software Engineer

Avatar for marcgreenstock

Marc Greenstock

Software Engineer, Infrastructure & Identity

Avatar for okbel

Bel Curcio

Engineering Manager

Avatar for angelazhang

Angela Zhang

Technical Program Manager

Legacy secrets are being sunset in favor of Sensitive Environment Variables, which are now shareable across projects.

  • Existing legacy secrets will be automatically converted. You do not need to manually take action for non-development values. Read below to view your impacted projects.
  • All Environment Variables remain securely encrypted. The majority of Vercel workloads have moved from the legacy secrets functionality.

On May 1st, 2024 secrets will be automatically converted to sensitive Environment Variables for Preview and Production environments. Secrets attached to Development environments will not be migrated.

Why are legacy secrets being sunset?

Our legacy secrets were encrypted values global for your entire team and could only be managed through the CLI. Based on your feedback, we have since:

When will I no longer be able to use secrets?

On May 1st, 2024secrets will be removed from Vercel CLI:

  • Existing secrets added to the Preview and Production environments will be converted to Sensitive Environment Variables
  • Existing secrets added to the Development environment will not be migrated for your security. If you have a secret shared between all environments, including Development, it will not be migrated. These values must be manually migrated.

How can I migrate to Sensitive Environment Variables?

Secrets for Preview and Production environments will be automatically migrated.

For secrets which contain the Development environment, you should create new Sensitive Environment Variables, as these values will not be automatically migrated for your security. If you need to share Environment Variables across projects, you can make them shared.

How can I understand if I’m affected?

To list projects using secrets that will be automatically converted, run:

vercel secrets ls
View the secrets added to your Vercel teams.