# What changed in tldts

> 14 changes in tldts 7 from its official release notes, upgrade guides and advisories: 6 breaking, 1 security, 2 new APIs and options. Each one cited. Sources checked 2026-10-24. HTML: https://unstale.sh/npm/tldts/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## tldts 7

### Breaking changes

- The Public Suffix List was updated, which may change domain parsing results for affected suffixes. (7.4.16) — [release notes](https://github.com/remusao/tldts/releases/tag/v7.4.16)
- Hostname labels that begin with a hyphen are now rejected. (7.3.1) — [release notes](https://github.com/remusao/tldts/releases/tag/v7.3.1)
- Hostname extraction now matches WHATWG URL host boundaries. (7.1.1) — [release notes](https://github.com/remusao/tldts/releases/tag/v7.1.1)
- Updates the upstream public suffix list in tldts-experimental, tldts-icann, and tldts, which may change suffix-related results. (7.0.22) — [release notes](https://github.com/remusao/tldts/releases/tag/v7.4.18), [release notes](https://github.com/remusao/tldts/releases/tag/v7.4.15), [release notes](https://github.com/remusao/tldts/releases/tag/v7.4.19), [release notes](https://github.com/remusao/tldts/releases/tag/v7.4.14), [release notes](https://github.com/remusao/tldts/releases/tag/v7.4.13), [release notes](https://github.com/remusao/tldts/releases/tag/v7.4.12), [release notes](https://github.com/remusao/tldts/releases/tag/v7.4.10), [release notes](https://github.com/remusao/tldts/releases/tag/v7.4.9), [release notes](https://github.com/remusao/tldts/releases/tag/v7.0.31), [release notes](https://github.com/remusao/tldts/releases/tag/v7.0.22)
- The upstream Public Suffix List was updated, which may change domain parsing results for affected suffixes. (7.0.18) — [release notes](https://github.com/remusao/tldts/releases/tag/v7.4.8), [release notes](https://github.com/remusao/tldts/releases/tag/v7.4.6), [release notes](https://github.com/remusao/tldts/releases/tag/v7.4.5), [release notes](https://github.com/remusao/tldts/releases/tag/v7.4.3), [release notes](https://github.com/remusao/tldts/releases/tag/v7.4.1), [release notes](https://github.com/remusao/tldts/releases/tag/v7.0.27), [release notes](https://github.com/remusao/tldts/releases/tag/v7.0.25), [release notes](https://github.com/remusao/tldts/releases/tag/v7.0.24), [release notes](https://github.com/remusao/tldts/releases/tag/v7.0.20), [release notes](https://github.com/remusao/tldts/releases/tag/v7.0.18)
- When validateHostname is enabled, hostname validation is consistent between getHostname and parse(url).hostname. (7.0.0) — [release notes](https://github.com/remusao/tldts/releases/tag/v7.0.0)

### Security

- Adds IPv6 hextet validation as security-review hardening. (7.1.2) — [release notes](https://github.com/remusao/tldts/releases/tag/v7.1.2)

### New APIs and options

- Adds getFullDomain to return the full hostname including its subdomain. (7.4.0) — [release notes](https://github.com/remusao/tldts/releases/tag/v7.4.0)
- Adds opt-in detection of IANA special-use domains. (7.2.0) — [release notes](https://github.com/remusao/tldts/releases/tag/v7.2.0)

### Performance

- Hostname validation is performed inline during extraction, dropping a redundant scan. (7.3.0) — [release notes](https://github.com/remusao/tldts/releases/tag/v7.3.0)
- Performance improved and memory allocations were reduced. (7.1.0) — [release notes](https://github.com/remusao/tldts/releases/tag/v7.1.0)

### Behavior and default changes

- Updated the upstream public suffix list, which may affect domain parsing results. (7.0.19) — [release notes](https://github.com/remusao/tldts/releases/tag/v7.4.11), [release notes](https://github.com/remusao/tldts/releases/tag/v7.4.7), [release notes](https://github.com/remusao/tldts/releases/tag/v7.4.4), [release notes](https://github.com/remusao/tldts/releases/tag/v7.4.2), [release notes](https://github.com/remusao/tldts/releases/tag/v7.0.30), [release notes](https://github.com/remusao/tldts/releases/tag/v7.0.29), [release notes](https://github.com/remusao/tldts/releases/tag/v7.0.28), [release notes](https://github.com/remusao/tldts/releases/tag/v7.0.26), [release notes](https://github.com/remusao/tldts/releases/tag/v7.0.23), [release notes](https://github.com/remusao/tldts/releases/tag/v7.0.21), [release notes](https://github.com/remusao/tldts/releases/tag/v7.0.19)

### Fixes and other changes

- Extraction now handles unbracketed IPv6 hostnames instead of mangling them. (7.2.1) — [release notes](https://github.com/remusao/tldts/releases/tag/v7.2.1)
- Labels ending with an underscore are now accepted. (7.0.32) — [release notes](https://github.com/remusao/tldts/releases/tag/v7.0.32)