NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm, #1546 most downloaded on npm
A function to check whether a prop is valid for HTML and SVG elements
Latest stable
1.4.0
Last release 1 years ago
04 Sep 2025
Ships fairly regularly
a new release about every 4 months
Some releases are documented
notes for 19 of 33 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
39 releases · first in 2018
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
Nothing published for this version
Nothing published for this version
### Minor Changes - #3306 `dfae1cb` Thanks @EnzoAlbornoz! - Adds popover, popoverTarget and popoverTargetAction to the list of allowed props.
dfae1cb Thanks @EnzoAlbornoz! - Adds popover, popoverTarget and popoverTargetAction to the list of allowed props.Your coding agent can read these notes before it upgrades. Set up the MCP server →
#3198 d8ff8a5 Thanks @Andarist! - Migrated away from relying on process.env.NODE_ENV checks to differentiate between production and development builds.
Development builds (and other environment-specific builds) can be used by using proper conditions (see here). Most modern bundlers/frameworks already preconfigure those for the user so no action has to be taken.
Default files should continue to work in all environments.
#3215 a9f6912 Thanks @Andarist! - Added edge-light and workerd conditions to package.json manifest to better serve users using Vercel Edge and Cloudflare Workers.
Updated dependencies \[`153cf88`]:
153cf88]:
532ff57 Thanks @codejet, @DustinBrett! - Adds fetchpriority and fetchPriority to the list of allowed props.Development builds (and other environment-specific builds) can be used by using proper conditions (see here). Most modern bundlers/frameworks already
#3198 d8ff8a5 Thanks @Andarist! - Migrated away from relying on process.env.NODE_ENV checks to differentiate between production and development builds.
Development builds (and other environment-specific builds) can be used by using proper conditions (see here). Most modern bundlers/frameworks already preconfigure those for the user so no action has to be taken.
Default files should continue to work in all environments.
16d8a8c Thanks @rjdestigter! - Source code has been migrated to TypeScript. From now on type declarations will be emitted based on that, instead of being hand-written.52aadc6 Thanks @sarayourfriend! - Source code has been migrated to TypeScript. From now on type declarations will be emitted based on that, instead of being hand-written.52aadc6 Thanks @sarayourfriend! - Type declaration for StyleSheet's constructor has been fixed. It incorrectly was specifying that options were optional when in reality they weren't.a1e881b Thanks @sarayourfriend! - Source code has been migrated to TypeScript. From now on type declarations will be emitted based on that, instead of being hand-written.7f8db2d]:
### Patch Changes - #3156 `0bfa9786` Thanks @nnguyen01! - Adds disableRemotePlayback to the list of allowed props.
0bfa9786 Thanks @nnguyen01! - Adds disableRemotePlayback to the list of allowed props.### Patch Changes - #3029 `eed5e6cf` Thanks @Andarist! - Fixed importing in Node ESM
### Minor Changes - #2819 `bbad8c79` Thanks @nicksrandall! - exports field has been added to the package.json manifest. It limits what files can be im
#2819 bbad8c79 Thanks @nicksrandall! - exports field has been added to the package.json manifest. It limits what files can be imported from a package but we've tried our best to allow importing all the files that were considered to be a part of the public API.
#2819 bbad8c79 Thanks @nicksrandall! - Thanks to the added exports field, the package now includes a worker condition that can be utilized by properly configured bundlers when targeting worker-like environments. It fixes the issue with browser-specific files being prioritized by some bundlers when targeting workers.
bbad8c79 Thanks @nicksrandall! - exports field has been added to the package.json manifest. It limits what files can be imported from a package but we've tried our best to allow importing all the files that were considered to be a part of the public API.bbad8c79]:
9ca22c6 Thanks @danilofuchs! - Source code has been migrated to TypeScript. From now on type declarations will be emitted based on that, instead of being hand-written.### Patch Changes - #2759 Thanks @srmagura! - Change the type of the argument to isPropValid from PropertyKey to string in the TypeScript definitions.
45c440fb Thanks @Cerber-Ursi! - Replace arrays with readonly arrays in CSS type definitions, following changes in csstype### Patch Changes - #2621 `d2531639` Thanks @andreasmcdermott! - Added `abbr` prop to the allowlist of forwardable props.
d2531639 Thanks @andreasmcdermott! - Added abbr prop to the allowlist of forwardable props.### Patch Changes - #2929 `13afe030` Thanks @Andarist! - Updated the underlying parser (stylis).
Updated dependencies \[`bbad8c79`, `bbad8c79`]:
bbad8c79 Thanks @nicksrandall! - exports field has been added to the package.json manifest. It limits what files can be imported from a package but we've tried our best to allow importing all the files that were considered to be a part of the public API.#3198 d8ff8a5 Thanks @Andarist! - Migrated away from relying on process.env.NODE_ENV checks to differentiate between production and development builds.
Development builds (and other environment-specific builds) can be used by using proper conditions (see here). Most modern bundlers/frameworks already preconfigure those for the user so no action has to be taken.
Default files should continue to work in all environments.
#3215 a9f6912 Thanks @Andarist! - Added edge-light and workerd conditions to package.json manifest to better serve users using Vercel Edge and Cloudflare Workers.
### Major Changes - #2867 `89b6dbb3` Thanks @Andarist! - A wrapper package that uses useInsertionEffect or a specific fallback for it. It comes with t
9e998e37 #1817 Thanks @Andarist! - insertStyles no longer calls cache.insert with a scoped class name as a selector when inserting keyframes. The change is internal and has no effect on Emotion users.9e998e37 #1817 Thanks @Andarist! - @import rules are no longer special-cased - they no longer are always inserted at the beginning of the stylesheet. The responsibility to put them first has been moved to a consumer of this package.4a891bf6 #1473 Thanks @jcharry! - The new prepend option can make Emotion add style tags at the beginning of the specified DOM container instead of the end.
dfe79aca #1696 Thanks @Andarist! - Added hydrate method which can be used for SSRed styles. They become a part of a sheet and can be flushed.
42df3f3b #2028 Thanks @Andarist! - Generated style elements got data-s="1" attribute so @emotion/cache can recognize them as being already owned by another Emotion copy to avoid messing up existing style elements when initializing a new copy.
1e4a741d #1697 Thanks @Andarist! - Removed mentions of maxLength option in types & docs as it has been removed some time ago.
c6431074 #1609 Thanks @tomsseisums! - Reworked Interpolation-related types. Correct types should now be provided to all flavours of Emotion.5d692a6a #1956 Thanks @eps1lon! - Upgraded csstype dependency to its v3. This is what we use to provide TypeScript typings for object styles. The upgrade should not affect any consuming code but it's worth mentioning if any edge case scenarios arise.e3d7db87 #1732 Thanks @Andarist! - An additional semicolon is now inserted after interpolated arrays to cover cases when it doesn't have a trailing semi itself and thus breaking composition with styles coming after it.
8a896a31 #1611 Thanks @Andarist! - Throw error about invalid content property values instead of just logging error to the console.
5c55fd17 #1653 Thanks @Andarist! - Fix to what location generated source maps are pointing in case of composed styles.
a085003d #1613 Thanks @Andarist! - Add missing #__PURE__ annotations
Updated dependencies [debaad9a, 9e998e37]:
923ded01 #1643 Thanks @JakeGinnivan! - Allow isPropValid to take any PropertyKey as an argument (instead of just string).69446cb5 #1971 Thanks @mjcampagna! - translate got added to the list of the valid props.`9c4ebc16` #2030 Thanks @Andarist! - Release candidate version.
`923ded01` #1643 Thanks @JakeGinnivan! - Allow isPropValid to take any PropertyKey as an argument (instead of just string).
923ded01 #1643 Thanks @JakeGinnivan! - Allow isPropValid to take any PropertyKey as an argument (instead of just string).`babbbe3` #1792 Thanks @egdbear! - Adds disablePictureInPicture to the list of allowed props.
`12141c5` #1736 Thanks @bezoerb! - Adds inert to the list of allowed props
`4c62ae9` #1698 Thanks @Andarist! - Add LICENSE file
`a085003d` #1613 Thanks @Andarist! - Add missing #__PURE__ annotations
`5e17e456` #1596 Thanks @Andarist! - Added Flow types to the package.
`6cdb5695` #1584 Thanks @probablyup! - add "on" amp html attribute to the whitelist
6cdb5695 #1584 Thanks @probablyup! - add "on" amp html attribute to the whitelistUpdated dependencies [c81c0033]:
c0eb604d #1419 Thanks @emmatown! - Update build tool
### Patch Changes - #3029 `eed5e6cf` Thanks @Andarist! - Fixed importing in Node ESM - #3012 `e6e5b3d7` Thanks @sgrishchenko! - Add aspectRatio as a u
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.