Tailwind CSS v4.1.6 — Release Notes & Engineering Impact

Source available — automated, not human-reviewed

Component: tailwind · Channel: stable. Automated analysis, not a compatibility certification. How this works.

Analysis updated: 2026-11-01.

Compatibility not verified — check source notes

$ npm install --save-exact [email protected]

📄 .MD

✨ Features 3 🔧 Bug Fixes 6

⚡ Executive Summary (TL;DR)

Tailwind CSS v4.1.6. Source highlight: Upgrade: Automatically convert arbitrary values to named values when possible (e.g. `h-[1lh]` to `h-lh`) (#17831, #17854)

Visit Tailwind CSS Official Site ↗ Official Release Source ↗ All Tailwind CSS Releases 📡 Tailwind CSS RSS

Who Does This Impact? (Role-Based Analysis)

💻 Software Engineers & Devs

Check the source notes against the package and APIs you use before upgrading.

📊 Product & Engineering Leads

Use the documented changes to assess relevance to your product; release frequency alone is not a quality measure.

⚙️ DevOps & Security

Verify the target version, runtime requirements and rollback procedure in the official documentation.

✨ New Features & Capabilities (3)

Upgrade: Automatically convert arbitrary values to named values when possible (e.g. `h-[1lh]` to `h-lh`) (#17831, #17854)
Upgrade: Update dependencies in parallel for improved performance (#17898)
Add support for generating source maps in development (#17775)

🔧 Bug Fixes & Patches (6)

Add detailed logging about `@source` directives, discovered files and scanned files when using `DEBUG=*` (#17906, #17952)
Ensure negative arbitrary `scale` values generate negative values (#17831)
Fix HAML extraction with embedded Ruby (#17846)
Don't scan files for utilities when using `@reference` (#17836)
Fix incorrectly replacing `_` with ` ` in arbitrary modifier shorthand `bg-red-500/(--my_opacity)` (#17889)
Don't scan `.log` files for classes by default (#17906)

📄 View Raw Release Notes (Original Developer Log)

### Added - Upgrade: Automatically convert arbitrary values to named values when possible (e.g. `h-[1lh]` to `h-lh`) ([#17831](https://github.com/tailwindlabs/tailwindcss/pull/17831), [#17854](https://github.com/tailwindlabs/tailwindcss/pull/17854)) - Upgrade: Update dependencies in parallel for improved performance ([#17898](https://github.com/tailwindlabs/tailwindcss/pull/17898)) - Add detailed logging about `@source` directives, discovered files and scanned files when using `DEBUG=*` ([#17906](https://github.com/tailwindlabs/tailwindcss/pull/17906), [#17952](https://github.com/tailwindlabs/tailwindcss/pull/17952)) - Add support for generating source maps in development ([#17775](https://github.com/tailwindlabs/tailwindcss/pull/17775)) ### Fixed - Ensure negative arbitrary `scale` values generate negative values ([#17831](https://github.com/tailwindlabs/tailwindcss/pull/17831)) - Fix HAML extraction with embedded Ruby ([#17846](https://github.com/tailwindlabs/tailwindcss/pull/17846)) - Don't scan files for utilities when using `@reference` ([#17836](https://github.com/tailwindlabs/tailwindcss/pull/17836)) - Fix incorrectly replacing `_` with ` ` in arbitrary modifier shorthand `bg-red-500/(--my_opacity)` ([#17889](https://github.com/tailwindlabs/tailwindcss/pull/17889)) - Don't scan `.log` files for classes by default ([#17906](https://github.com/tailwindlabs/tailwindcss/pull/17906)) - Ensure that custom utilities applying other custom utilities don't swallow nested `@apply` rules ([#17925](https://github.com/tailwindlabs/tailwindcss/pull/17925)) - Download platform specific package if `optionalDependencies` are skipped ([#17929](https://github.com/tailwindlabs/tailwindcss/pull/17929))

← Older Version Tailwind CSS v4.1.5 Newer Version → Tailwind CSS v4.1.7