●Change8

Migrating to Pydantic Settings v2.12.0

Version v2.12.0 introduces 1 breaking change. This guide details how to update your code.

Released: 11/10/2025

1
Breaking Changes
3
Migration Steps
4
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

NestedSecretsSettingsBaseSettingsSettingsSourceEnum

Breaking Changes

●Issue #1

Python 3.9 support has been removed. Projects must upgrade to Python 3.10 or newer.

Migration Steps

  1. 1
    If you relied on implicit default values, update your settings to define explicit defaults.
  2. 2
    Review any code that depends on the order of settings sources; the new order is init > env > dotenv > secrets > defaults.
  3. 3
    When using strict mode, ensure environment variable values are compatible with the expected types.

Release Summary

pydantic-settings 2.12 introduces enum kebab‑case support, a new NestedSecretsSettings source, updated source ordering, and adds Python 3.14 support while dropping Python 3.9.

Need More Details?

View the full release notes and all changes for Pydantic Settings v2.12.0.

View Full Changelog