Compare Versions - next-intl

npm/next-intl/Compare Versions

View on npm

→Compare

4.14.1

4.14.1 (2026-08-28)

Bug Fixes

• Unbreak experimental.messages without a messages.sourceLocale (#2395) (67fca94) – by @amannn

4.14.0

4.14.0 (2026-08-27)

Features

• useExtracted improvements (#2346) (4ccf3b8) – by @amannn

4.13.7

4.13.7 (2026-08-17)

Bug Fixes

• Pin @swc/core to a range that is compatible with the extractor plugin (#2389) (a37d8aa) – by @amannn

4.13.6

4.13.6 (2026-08-10)

Bug Fixes

• Deprecate requestLocale param of getRequestConfig (#2380) (ae770af) – by @amannn

4.13.5

4.13.5 (2026-08-04)

Bug Fixes

• Deprecate setRequestLocale and add blog post on next/root-params (#1632) (1446d0d) – by @amannn

4.13.4

4.13.4 (2026-07-23)

Bug Fixes

• Avoid usePathname() reads for non-locale-switching links, avoiding unnecessary <Suspense> wrappers with partial prefetching (#2362) (82de47f) – by @ceolinwill

4.13.3

4.13.3 (2026-07-21)

Bug Fixes

• Next.js 16.3 compatibility preparation (only update locale cookie for document requests and not prefetches) (#2355) (0555ace) – by @amannn

4.13.2

4.13.2 (2026-07-10)

Bug Fixes

• Correctly format plural/select branches that are only # or empty (#2356) (cc34d9a) – by @spokodev

4.13.1

4.13.1 (2026-06-30)

Bug Fixes

• Handle ICU escape sequences around < consistently in dev and production (#2352) (4025d1f) – by @amannn

4.13.0

4.13.0 (2026-05-28)

Features

• Use URL-safe base64 for auto-generated message keys of useExtracted (#2330) (a003d3a) – by @spokodev

4.12.0

4.12.0 (2026-05-13)

Features

• Improvements for useExtracted (#2316) (bff2f96) – by @amannn

4.11.2

4.11.2 (2026-05-11)

Bug Fixes

• Revert x-forwarded-host redirect domain change (#2322) (eb3a6a4) – by @amannn

4.11.1

4.11.1 (2026-05-08)

Bug Fixes

• Avoid watchers for detached telemetry process (#2319) (ff77a3d) – by @amannn

4.11.0

4.11.0 (2026-04-28)

Features

• Add displayName to useFormatter (#2285) (3666aa8) – by @roderickhsiao

4.10.1

4.10.1 (2026-04-28)

Bug Fixes

• Set redirect domain if x-forwarded-host header exists (#2281) (70d35db) – by @FourwingsY

4.10.0

4.10.0 (2026-04-28)

Features

• Add per-domain localePrefix override support (#2273) (3e9febf) – by @frankmatheron

4.9.2

4.9.2 (2026-04-27)

Bug Fixes

• Prototype safety guards for precompile: true (#2307) (c0bf0ee) – by @amannn

4.9.1

4.9.1 (2026-04-10)

Bug Fixes

• Improve middleware pathname validation (#2304) (1c80b66) – by @amannn

4.9.0

4.9.0 (2026-04-01)

Features

• Support transitionTypes on Link (#2302) (02811f5) – by @amannn

4.8.4

4.8.4 (2026-03-31)

Bug Fixes

• Remove TypeScript peer dependency and update examples to TypeScript v6 (#2293) (5e7bcd7) – by @wojtekmaj

4.8.3

4.8.3 (2026-02-16)

Bug Fixes

• Update @formatjs/intl-localematcher (#2265) (196f1f3) – by @amannn

4.8.2

4.8.2 (2026-02-02)

Bug Fixes

• Avoid throwing config errors for non-Next.js consumers of next.config.ts (#2245) (f57800e) – by @amannn

4.8.1

4.8.1 (2026-01-30)

Bug Fixes

• Fix precompile alias on Windows (#2237) (8e7151a) – by @amannn

4.8.0

4.8.0 (2026-01-28)

Features

• Ahead-of-time compilation for messages (blog post, #2220) – by @amannn

Fixes

• Normalization of file references for useExtracted (#2230) – by @amannn

4.7.0

4.7.0 (2026-01-01)

Improvements for useExtracted

• Only run extraction for next dev and next build (not e.g. for next typegen)
• Include line numbers for file references in .po files
• Incorporate line numbers into sorting of messages within a single file (if you're using the default .po format)

(#2200) (ebc5e43) – by @amannn

4.6.1

4.6.1 (2025-12-16)

Bug Fixes

• Improvements for useExtracted (#2176) (3937e44) – by @amannn

4.6.0

4.6.0 (2025-12-12)

Features

• Custom formats for useExtracted, consistency fixes for file references, pruning of messages and sorting of keys (#2155) (c02818e) – by @amannn

4.5.8

4.5.8 (2025-12-03)

Bug fixes for useExtracted

• Append newline with .json formatter for useExtracted (https://github.com/amannn/next-intl/pull/2148 by @amannn)
• Handle multiple calls to useExtracted & getExtracted (https://github.com/amannn/next-intl/pull/2149 by @amannn)
• Avoid conflict with existing useTranslations import for useExtracted (https://github.com/amannn/next-intl/pull/2150 by @amannn)

4.5.7

4.5.7 (2025-12-01)

Bug Fixes

• Skip accept-language parsing when locale cookie is already present (#2143) (0d1331b), closes #2116 – by @lxup

4.5.6

4.5.6 (2025-11-27)

Bug fixes for useExtracted

• Handle race condition when detecting locale changes which could lead to reset of messages with useExtracted (https://github.com/amannn/next-intl/pull/2131 – by @amannn)
• Don't depend on environment locale for sorting of keys with useExtracted (https://github.com/amannn/next-intl/pull/2134 – by @amannn)
• Retain .po flags for useExtracted and update po-parser to fix encoding (https://github.com/amannn/next-intl/pull/2128 – by @amannn)

4.5.5

4.5.5 (2025-11-19)

Bug Fixes

• Move SWC cache to node_modules (#2120) (0ba9105) – by @amannn

4.5.4

4.5.4 (2025-11-19)

Bug Fixes

• Move AST transformer of useExtracted to SWC plugin & handle source maps (#2114) (e63fbc5) – by @kdy1 & @amannn

4.5.3

4.5.3 (2025-11-13)

Bug Fixes

• Fix inconsistent ordering of messages for useExtracted pt. 2 (#2103) (5cbd5da) – by @amannn

4.5.2

4.5.2 (2025-11-12)

Bug Fixes

• Bug fixes for useExtracted (#2099) (b1ff1fa) – by @amannn

4.5.1

4.5.1 (2025-11-11)

Bug Fixes

• Avoid partial matches in overlapping localized pathnames (#2090) (c276c80), closes #2089 #2089 – by @amannn

4.5.0

4.5.0 (2025-11-07)

Features

• Add useExtracted (experimental) (#2080) (7a85644) – by @amannn

4.4.0

Changes

• Bump peer dependency for Next.js 16
• Update examples for Next.js 16
• Update docs to cover proxy.ts

🌐 learn.next-intl.dev has been updated for Next.js 16 as well (changelog)

---

#2054 by @amannn

4.3.12

4.3.12 (2025-10-09)

Bug Fixes

• Use correct return type for getTimeZone (#2053) (bdc2af4), closes #2052 – by @amannn

4.3.11

4.3.11 (2025-10-07)

Bug Fixes

• Only call NextResponse.rewrite if really necessary (#2051) (43ed4aa) – by @amannn

In case you're relying on x-middleware-rewrite being set on the response from the next-intl middleware (e.g. for additional rewrites), please see details in #2051.

4.3.10

4.3.10 (2025-10-07)

Bug Fixes

• Bump @types/react version (#2050) (c1e997e), closes #2044 #2044 – by @amannn

4.3.9

4.3.9 (2025-09-15)

Bug Fixes

• Prefix pathnames when switching with useRouter to another locale (#2021) (c82d0af), closes #2020 – by @amannn

4.3.8

4.3.8 (2025-09-12)

Bug Fixes

• Avoid double-encoding of already encoded params (#2017) (31265b4), closes #2014 – by @amannn

4.3.7

4.3.7 (2025-09-09)

Bug Fixes

• Avoid usePathname inconsistency in Next.js leading to a hydration error with custom prefixes, localePrefix: 'always' and static rendering (#2012) (bc9cb62), closes #2011 vercel/next.js#73085 #1571 – by @hugotiger

4.3.6

4.3.6 (2025-09-04)

Bug Fixes

• Ensure messages declaration continues working in next dev for upcoming next@15.5.1 (#2008) (2bf09ec) – by @amannn

4.3.5

4.3.5 (2025-08-21)

Bug Fixes

• Don't create messages declaration file when running next {start,info,telemetry} (#1992) (fd0722a) – by @amannn

4.3.4

4.3.4 (2025-07-02)

Bug Fixes

• Correctly compile messages containing escaped curly braces (e.g. '{name'}) (#1950) (4d418f4), closes #1948 – by @amannn

4.3.3

4.3.3 (2025-07-01)

Bug Fixes

• Add friendly error message when failing to load current Next.js version (#1945) (5021773) – by @cupofjoakim

4.3.2

4.3.2 (2025-07-01)

Bug Fixes

• Ensure cookie is synced before navigation with useRouter (#1947) (3ee9c4d) – by @amannn

4.3.1

4.3.1 (2025-06-24)

Bug Fixes

• Don't encode hashes in unknown pathnames (#1935) (65978d2) – by @amannn

4.3.0

4.3.0 (2025-06-23)

Features

• Support BigInt for number interpolation with useTranslations (#1929) (a893330), closes #1928 – by @sgleisner

4.2.0

4.2.0 (2025-06-23)

Features

• Encode non-ASCII characters in pathnames returned from navigation APIs (#1923) (3d23c61) – by @amannn

4.1.0

4.1.0 (2025-04-24)

Features

• Add forcePrefix option for redirect and getPathname (#1865) (5905976) – by @amannn

4.0.3

4.0.3 (2025-04-22)

Bug Fixes

• Support stable Turbopack config in Next.js 15.3 (#1850) (30ec8e0), closes #1838 – by @amannn

4.0.2

4.0.2 (2025-03-13)

Bug Fixes

• Allow to use IntlErrorCode in user code (#1788) (913d307), closes #1787 – by @amannn

4.0.1

4.0.1 (2025-03-12)

Bug Fixes

• Handle default exports correctly for moduleResolution: 'node' (#1785) (b7a4a83) – by @amannn

4.0.0

4.0.0 (2025-03-12)

See the announcement.

3.26.5

3.26.5 (2025-02-21)

Bug Fixes

• Handle query in <Link /> correctly when using localePrefix: 'as-needed' with domains (#1732) (ec8776e), closes #1731 – by @amannn

3.26.4

3.26.4 (2025-02-18)

Bug Fixes

• Add workaround for OpenTelemetry/Zone.js (#1719) (1cac9a6), closes #1711 – by @amannn

3.26.3

3.26.3 (2024-12-20)

Bug Fixes

• Add missing deprecation warnings for next-intl@4.0 (#1485) (1d60d08) – by @amannn

3.26.2

3.26.2 (2024-12-18)

Bug Fixes

• Support t.has when getTranslations is called with an object argument (#1616) (64895a2) – by @amannn

3.26.1

3.26.1 (2024-12-11)

Bug Fixes

• Use new domain next-intl.dev in links (#1601) (40a9a77) – by @amannn

3.26.0

3.26.0 (2024-12-06)

Features

• Support React 19 (#1597) (e0ffe29) – by @amannn

3.25.3

3.25.3 (2024-11-26)

Bug Fixes

• Follow-up for #1573 to also handle the case when a non-default locale is in use (#1578) (fd71741), closes #1568 – by @amannn

3.25.2

3.25.2 (2024-11-25)

Bug Fixes

• Handle inconsistency in Next.js when using usePathname with custom prefixes, localePrefix: 'as-needed' and static rendering (#1573) (20fd0f0) – by @amannn

3.25.1

3.25.1 (2024-11-13)

Bug Fixes

• Correctly handle search params in redirects when using trailingSlash: true (#1537) (03a4620) – by @deini

3.25.0

3.25.0 (2024-11-08)

Features

• Add type exports to enable declaration: true in tsconfig.json (#1509) (6b2ca9c) – by @osaton

3.24.0

3.24.0 (2024-10-31)

Features

• Add support for React 19 RC (#1490) (2dea022) – by @amannn

3.23.5

3.23.5 (2024-10-24)

Bug Fixes

• Don't warn when setting prefetch={true} on <Link /> (#1463) (fd6d73d), closes #1462 – by @amannn

3.23.4

3.23.4 (2024-10-24)

Bug Fixes

• Upgrade to negotiator@^1.0 (#1460) (b93f297) – by @amannn

3.23.3

3.23.3 (2024-10-24)

Bug Fixes

• Resolve locale for navigation APIs consistently from i18n/request.ts in react-server like all other APIs do (#1459) (8c6d5ff) – by @amannn

3.23.2

3.23.2 (2024-10-22)

Bug Fixes

• Handle inlined search params and hashes correctly in <Link /> from createNavigation (#1448) (ba0a537) – by @amannn

3.23.1

3.23.1 (2024-10-22)

Bug Fixes

• Remove usage of deprecated ReactNodeArray which is removed in React 19 (#1445) (2396345) – by @amannn

3.23.0

3.23.0 (2024-10-22)

Features

• Add Next.js 15 to peer dependencies (#1443) (4cb22bb) – by @amannn

3.22.0

3.22.0 (2024-10-21)

→ See blog post: next-intl 3.22: Incrementally moving forward

Features

• feat: createNavigation (#1316)
• feat: Add async requestLocale param to getRequestConfig for Next.js 15 support (#1383)
• feat: Add localeCookie option for middleware (#1414)
• feat: Add setRequestLocale (#1437)

Fixes

• fix: When using domains, handle unknown domains more gracefully (#1389)

Deprecations

• Deprecate defaultTranslationValues (#1411)
• Deprecate unstable_setRequestLocale (#1437)

3.21.1

3.21.1 (2024-10-09)

Bug Fixes

• Repair package publishing workflow (this release doesn't include any library changes) (ceba9ae) – by @amannn

3.20.0

3.20.0 (2024-09-24)

Features

• Type-safe global formats (#1346) (b7aa14e) – by @dBianchii

3.19.5

3.19.5 (2024-09-24)

Bug Fixes

• Make all keys of Formats type optional for easier usage (#1367) (a7cbd9b) – by @amannn

3.19.4

3.19.4 (2024-09-19)

Bug Fixes

• Handle malformed pathnames in middleware (#1353) (dcda9d9), closes #1351 – by @amannn

3.19.3

3.19.3 (2024-09-17)

Bug Fixes

• Handle overlapping locale prefixes correctly pt. 2 (#1344) (7958659) – by @amannn

3.19.2

3.19.2 (2024-09-17)

Bug Fixes

• Handle overlapping custom locale prefixes correctly (#1343) (72c1731), closes #1329 – by @amannn

3.19.1

3.19.1 (2024-09-05)

Bug Fixes

• Add error handling in case an invalid i18n request config file has been specified (#1327) (18b9fd6) – by @amannn

3.19.0

3.19.0 (2024-08-30)

Features

• Support ./i18n/request.ts in addition to ./i18n.ts (#1308) (258e95e) – by @amannn

3.18.1

3.18.1 (2024-08-29)

Bug Fixes

• Print warning for inconsistent i18n setup where no locale is read in getRequestConfig and also none is returned (#1305) (2f0f781) – by @amannn

3.18.0

3.18.0 (2024-08-28)

Features

• Add defineRouting for easier i18n routing setup (#1299) (5ff6120) – by @amannn

3.17.6

3.17.6 (2024-08-23)

Bug Fixes

• Enable React Compiler ESLint plugin and fix relevant case (#1281) (606f4cc)– by @amannn

3.17.5

3.17.5 (2024-08-23)

Bug Fixes

• Lazy init message formatter for improved tree shaking in case useTranslations is only used in Server Components (#1279) (9f1725c) – by @amannn

3.17.4

3.17.4 (2024-08-20)

Bug Fixes

• Update @formatjs/intl-localematcher to latest version (#1140) (c217582) – by @amannn

3.17.3

3.17.3 (2024-08-14)

Bug Fixes

• Handle optional catch-all segments in navigation APIs if no value is provided and handle the case if a dynamic value appears multiple times in a pathname (#1259) (58ef482), closes #1236 – by @amannn

3.17.2

3.17.2 (2024-07-19)

Bug Fixes

• Fix open redirect vulnerability for localePrefix: 'as-necessary' by sanitizing pathname in the middleware (#1208) (f42ac01), closes #1207 – by @hblee12294

3.17.1

3.17.1 (2024-07-15)

Bug Fixes

• Apply useMemo for useRouter returned from createLocalizedPathnamesNavigation to keep a stable reference when possible (#1201) (a1b9a36), closes #1198 – by @amannn

3.17.0

3.17.0 (2024-07-12)

Features

• Cache Intl.* constructors (#1193) (52c4f2c), closes #215 – by @amannn

3.16.0

3.16.0 (2024-07-11)

Features

• Support trailingSlash: true in Next.js config (#1190) (cfbdee9) – by @amannn

3.15.5

3.15.5 (2024-07-09)

Bug Fixes

• Support relative pathnames in redirect (#1178) (3b698d7), closes #1177 – by @amannn

3.15.4

3.15.4 (2024-07-08)

Bug Fixes

• Export DomainsConfig (#1175) (c4d1bb0) – by @amannn

3.15.3

3.15.3 (2024-06-26)

Bug Fixes

• Prefer more specific routes in usePathname when detecting the currently active pathname for localized pathnames (#1152) (936839e), closes #1151 – by @amannn

3.15.2

3.15.2 (2024-06-19)

Note: Version bump only for package root

3.15.1

3.15.1 (2024-06-19)

Bug Fixes

• Remove @formatjs/ecma402-abstract dependency in favor of the automatically bundled one from intl-messageformat (https://github.com/amannn/next-intl/pull/1141) – by @amannn