# idna changelog

> idna release notes.

- Vendor: idna
- Category: Frameworks & Libraries
- Official site: https://github.com/kjd/idna
- Tracked by: What's New (https://whatsnew.fyi/product/idna)
- Harvested from: GitHub (kjd/idna)
- Entries below: 10 (newest first)

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

## Releases

### v3.18

- Date: 2026-06-02
- Version: v3.18
- Original notes: https://github.com/kjd/idna/releases/tag/v3.18
- Permalink: https://whatsnew.fyi/product/idna/releases/v3.18

- When decoding a domain, add a `display` argument that will pass
  through invalid labels rather than raising an exception.

### v3.17

- Date: 2026-05-28
- Version: v3.17
- Original notes: https://github.com/kjd/idna/releases/tag/v3.17
- Permalink: https://whatsnew.fyi/product/idna/releases/v3.17

- Substantial 75% reduction in memory usage through new data
  structures and some optimization in processing speed.
- Added a general 1024-character input length cap to the public
  validation, conversion, and codec entry points. This is well above
  any legitimate domain or label and guards against pathological
  inputs.

### v3.16

- Date: 2026-05-22
- Version: v3.16
- Original notes: https://github.com/kjd/idna/releases/tag/v3.16
- Permalink: https://whatsnew.fyi/product/idna/releases/v3.16

- Add a command-line interface (`python -m idna`, also available as
  the `idna` script). Encodes or decodes one or more domains supplied
  as arguments or on standard input, with options to select A-label
  or U-label output and control error handling.
- Raise the minimum supported Python version to 3.9
- Various code quality improvements

### v3.15

- Date: 2026-05-12
- Version: v3.15
- Original notes: https://github.com/kjd/idna/releases/tag/v3.15
- Permalink: https://whatsnew.fyi/product/idna/releases/v3.15

- Enforce DNS-length cap on individual labels early in `check_label`,
  short-circuiting contextual-rule processing for oversized input
  while staying compatible with UTS 46 usage.
- Tidy core helpers: hoist bidi category sets to module-level
  frozensets (avoiding per-codepoint list construction), simplify
  length checks, and reuse the shared `_unicode_dots_re` from
  `idna.core` in the codec module.
- Use `raise ... from err` for proper exception chaining and
  switch internal string formatting to f-strings.
- Allow `flit_core` 4.x in the build backend.
- Expand the ruff lint set (flake8-bugbear, flake8-simplify,
  pyupgrade, perflint) and apply the surfaced fixes; pin lint CI
  to Python 3.14.
- Add Dependabot configuration for GitHub Actions.
- Convert README and HISTORY from reStructuredText to Markdown.
- Reference CVE-2026-45409 for the 3.14 advisory in place of the
  initial GHSA identifier.

Thanks to Felix Yan, Stan Ulbrych, and metsw24-max for
contributions to this release.

### v3.14

- Date: 2026-05-10
- Version: v3.14
- Original notes: https://github.com/kjd/idna/releases/tag/v3.14
- Permalink: https://whatsnew.fyi/product/idna/releases/v3.14

- Removed opportunity to process long inputs into quadratic
  time by rejecting oversize inputs up-front. Closes a bypass
  of the CVE-2024-3651 mitigation. [CVE-2026-45409]

Thanks to Stan Ulbrych for reporting the issue.

### v3.13

- Date: 2026-04-22
- Version: v3.13
- Original notes: https://github.com/kjd/idna/releases/tag/v3.13
- Permalink: https://whatsnew.fyi/product/idna/releases/v3.13

### v3.12

- Date: 2026-04-21
- Version: v3.12
- Original notes: https://github.com/kjd/idna/releases/tag/v3.12
- Permalink: https://whatsnew.fyi/product/idna/releases/v3.12

### v3.11

- Date: 2025-10-12
- Version: v3.11
- Original notes: https://github.com/kjd/idna/releases/tag/v3.11
- Permalink: https://whatsnew.fyi/product/idna/releases/v3.11

### v3.10

- Date: 2024-09-15
- Version: v3.10
- Original notes: https://github.com/kjd/idna/releases/tag/v3.10
- Permalink: https://whatsnew.fyi/product/idna/releases/v3.10

### v3.9

- Date: 2024-09-14
- Version: v3.9
- Original notes: https://github.com/kjd/idna/releases/tag/v3.9
- Permalink: https://whatsnew.fyi/product/idna/releases/v3.9