●Change8

Migrating to Poetry 2.3.0

Version 2.3.0 introduces 2 breaking changes. This guide details how to update your code.

Released: 1/18/2026

2
Breaking Changes
2
Migration Steps
10
Affected Symbols

⚠️ Check Your Code

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

poetry.utils._compat.metadatapoetry cache clearpoetry checkpoetry initpoetry newpoetry publishpoetry removepoetry env usepoetry env activatevirtualenvs.prompt

Breaking Changes

●Issue #1

Support for Python 3.9 has been dropped. Users must upgrade to Python 3.10 or newer.

●Issue #2

The default value for the configuration setting `installer.re-resolve` has been changed from `true` to `false`. If you relied on automatic re-resolution during installation, you must explicitly set `installer.re-resolve = true` in your configuration.

Migration Steps

  1. 1
    If you relied on automatic re-resolution during dependency installation, update your configuration to explicitly set `installer.re-resolve = true`.
  2. 2
    Update your Python environment to Python 3.10 or newer.

Release Summary

This release drops support for Python 3.9, changes the default for installer re-resolution, and introduces significant improvements for PEP 735 dependency groups and artifact publishing.

Need More Details?

View the full release notes and all changes for Poetry 2.3.0.

View Full Changelog