●Change8

Migrating to Tailwind CSS v4.3.0

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

Released: 5/8/2026

2
Breaking Changes
2
Migration Steps
16
Affected Symbols

⚠️ Check Your Code

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

container-size utilityscrollbar-width utilitiesscrollbar-color utilitiesscrollbar-gutter utilitieszoom utilitiestab utilities@variant directive@utility definition@plugin@tailwindcss/vite@tailwindcss/postcssarbitrary values canonicalization:has() variantsstart utilityend utilityPluginWithConfig type

Breaking Changes

●Issue #1

Arbitrary `:has()` variants defined using the old `[&:has(…)]` syntax will now be migrated to the new `has-[…]` syntax during canonicalization. If you rely on the old syntax in non-canonicalized contexts, update them to use `has-[…]`.

●Issue #2

The upgrade process no longer migrates inline `style` attributes (e.g., `style="flex-grow: 1"` will remain unchanged instead of potentially being converted to `style="grow: 1"`). This prevents unintended style attribute modifications.

Migration Steps

  1. 1
    If you rely on arbitrary `:has()` variants defined using the old `[&:has(…)]` syntax, update them to use the new `has-[…]` syntax.
  2. 2
    Review any inline `style` attributes that were previously being modified by Tailwind CSS during processing, as this behavior has been disabled.

Release Summary

This release introduces several new utilities, including container size, scrollbar control, zoom, and tab utilities. It also significantly improves the robustness and correctness of CSS canonicalization, especially concerning arbitrary values and `:has()` variants.

Need More Details?

View the full release notes and all changes for Tailwind CSS v4.3.0.

View Full Changelog