NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm · #3142 most downloaded on npm
Use Custom Properties Queries in CSS
Last release 2 days ago
02 Oct 2026
Release timing varies
gaps range from 8 days to 7 months
Nearly every release is documented
notes for 58 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
12 years old
99 releases · first in 2014
Fixed: Issue with duplicate custom property usage within a declaration
November 5, 2018
Fixed: Issue with nested fallbacks
October 2, 2018
Fixed: Issue with parsing custom properties that are not strings
One column per quarter.
October 2, 2018
postcss to 7.0.5 (patch)Fixed: Issue with regular :root and html properties not getting polyfilled
September 21, 2018
:root and html properties not getting polyfilledpostcss to 7.0.3 (patch)Fixed: Issue with multiple importFrom not getting combined
September 21, 2018
importFrom not getting combinedFixed: Do not break on an empty importFrom object
September 18, 2018
importFrom objectUpdated: PostCSS Values Parser 2
September 18, 2018
Fixed: Spacing is preserved before replaced variables.
September 17, 2018
Fixed: Workaround issue in postcss-values-parser incorrectly cloning nodes.
September 17, 2018
postcss-values-parser incorrectly cloning nodes.Added: New exportTo function to specify where to export custom properties to.
September 16, 2018
exportTo function to specify where to export custom properties to.importFrom option to specify where to import custom properties from.htmlstrict option, as using the fallback value isn’t necessarily more valid.preserve: "computed" option, as there seems to be little use in preserving custom property declarations while removing all usages of them.warnings and noValueNotifications options, as this should be the job of a linter tool.variables option, which is now replaced by importFromappendVariables option, which is now replaced by exportTo:root are not also transformed.Changed: preserve option defaults as true to reflect the browser climate
February 16, 2018
preserve option defaults as true to reflect the browser climatewarnings option defaults to false to reflect the browser climateReverted: preserve and warnings option to be added in major release
February 16, 2018
preserve and warnings option to be added in major releaseFixed: var() captures strictly var() functions and not xvar(), etc
February 15, 2018
var() captures strictly var() functions and not xvar(), etcvar() better captures whitespace within the functionvar() are now preservedpreserve option defaults as true to reflect the browser climatewarnings option defaults to false to reflect the browser climateAdded: noValueNotifications option
October 6, 2017
noValueNotifications option (#71)prefixedVariables variable name (#77)Added: Let "warnings" option silence all warnings
June 28, 2017
_May 15, 2017_ - Fixed: incorrect export
May 15, 2017
Added: compatibility with postcss v6.x
May 12, 2017
_February 1, 2017_ - Minor dependency update
February 1, 2017
Fixed: trailing space after custom property name causes duplicate empty property
April 22, 2016
Removed: compatibility with postcss v4.x
August 25, 2015
Added: warnings option allows you to disable warnings. (cssnext#186)
July 21, 2015
warnings option allows you to disable warnings.
(cssnext#186)Added: plugin now returns itself in order to expose a setVariables function that allow you to programmatically change the variables.
July 14, 2015
setVariables function
that allow you to programmatically change the variables.
(#35)Changed: messages and exceptions are now sent using postcss message API.
June 17, 2015
Added: preserve now support "computed" so only preserve resolved custom properties (see new option below)
April 8, 2015
preserve now support "computed" so only preserve resolved custom properties (see new option below)appendVariables allows you (when preserve is truthy) to append your variables as custom propertiesstrict: false allows your to avoid too many fallbacks added in your CSS.Added: JS defined variables are now resolved too
03 31, 2015
Added: variables defined in JS are now automatically prefixed with --
03 16, 2015
--
(0691784)Fixed: logs now have filename back
February 6, 2015
Removed: some code that seems to be useless
Fixed: issue when multiples undefined custom properties are referenced
December 2, 2014
Added: enhanced exceptions & messages
November 25, 2014
_November 12, 2014_ - Changed: upgrade to postcss 3
November 12, 2014
Fixed: more clear message for warning about custom prop used in non top-level :root
November 4, 2014
Fixed: warning about custom prop used in non :root
November 3, 2014
Added: warning when a custom prop is used in another place than :root
November 2, 2014
Added: JS-defined properties override CSS-defined
September 30, 2014
Added: nested custom properties usages are now correctly resolved
August 27, 2014
Changed: fallback now are always added by default (see why)
August 26, 2014
map option renamed to variablesChanged: GNU style error message
August 22, 2014
map option✨ First release based on rework-vars v3.1.1
August 1, 2014
✨ First release based on rework-vars v3.1.1
Your coding agent can read these notes before it upgrades. Set up the MCP server →