To install Sass 1.37.5, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• No user-visible changes.

See the full changelog for changes in earlier releases.

To install Sass 1.37.4, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• No user-visible changes.

See the full changelog for changes in earlier releases.

To install Sass 1.37.3, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• No user-visible changes.

See the full changelog for changes in earlier releases.

To install Sass 1.37.2, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• No user-visible changes.

See the full changelog for changes in earlier releases.

To install Sass 1.37.1, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• No user-visible changes.

See the full changelog for changes in earlier releases.

To install Sass 1.37.0, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

Dart API

• Potentially breaking bug fix: SassNumber.asSlash, SassNumber.withSlash(), and SassNumber.withoutSlash() have been marked as @internal. They were never intended to be used outside the sass package.

• Potentially breaking bug fix: SassException has been marked as @sealed to formally indicate that it's not intended to be extended outside of the sass package.

• Add a Value.withListContents() method that returns a new Sass list with the same list separator and brackets as the current value, interpreted as a list.

See the full changelog for changes in earlier releases.

To install Sass 1.36.0, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

Dart API

• Added compileToResult(), compileStringToResult(), compileToResultAsync(), and compileStringToResultAsync() methods. These are intended to replace the existing compile*() methods, which are now deprecated. Rather than returning a simple string, these return a CompileResult object, which will allow us to add additional information about the compilation without having to introduce further deprecations.

  • Instead of passing a sourceMaps callback to compile*(), pass sourceMaps: true to compile*ToResult() and access CompileResult.sourceMap.

  • The CompileResult object exposes a loadedUrls object which lists the canonical URLs accessed during a compilation. This information was previously unavailable except through the JS API.

See the full changelog for changes in earlier releases.

To install Sass 1.35.2, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• Potentially breaking bug fix: Properly throw an error for Unicode ranges that have too many ?s after hexadecimal digits, such as U+12345??.

• Potentially breaking bug fix: Fixed a bug where certain local variable declarations nested within multiple @if statements would incorrectly override a global variable. It's unlikely that any real stylesheets were relying on this bug, but if so they can simply add !global to the variable declaration to preserve the old behavior.

• Potentially breaking bug fix: Fix a bug where imports of root-relative URLs (those that begin with /) in @import rules would be passed to both Dart and JS importers as file: URLs.

• Properly support selector lists for the $extendee argument to selector.extend() and selector.replace().

• Fix an edge case where @extend wouldn't affect a selector within a pseudo-selector such as :is() that itself extended other selectors.

• Fix a race condition where meta.load-css() could trigger an internal error when running in asynchronous mode.

Dart API

• Use the @internal annotation to indicate which Value APIs are available for public use.

See the full changelog for changes in earlier releases.

To install Sass 1.35.1, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• Fix a bug where the quiet dependency flag didn't silence warnings in some stylesheets loaded using @import.

See the full changelog for changes in earlier releases.

To install Sass 1.35.0, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• Fix a couple bugs that could prevent some members from being found in certain files that use a mix of imports and the module system.

• Fix incorrect recommendation for migrating division expressions that reference namespaced variables.

JS API

• Add a quietDeps option which silences compiler warnings from stylesheets loaded through importers and load paths.

• Add a verbose option which causes the compiler to emit all deprecation warnings, not just 5 per feature.

See the full changelog for changes in earlier releases.

To install Sass 1.34.1, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• Fix a bug where --update would always compile any file that depends on a built-in module.

• Fix the URL for the @-moz-document deprecation message.

• Fix a bug with @for loops nested inside property declarations.

See the full changelog for changes in earlier releases.

To install Sass 1.34.0, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• Don't emit the same warning in the same location multiple times.

• Cap deprecation warnings at 5 per feature by default.

Command Line Interface

• Add a --quiet-deps flag which silences compiler warnings from stylesheets loaded through --load-paths.

• Add a --verbose flag which causes the compiler to emit all deprecation warnings, not just 5 per feature.

Dart API

• Add a quietDeps argument to compile(), compileString(), compileAsync(), and compileStringAsync() which silences compiler warnings from stylesheets loaded through importers, load paths, and package: URLs.

• Add a verbose argument to compile(), compileString(), compileAsync(), and compileStringAsync() which causes the compiler to emit all deprecation warnings, not just 5 per feature.

See the full changelog for changes in earlier releases.

To install Sass 1.33.0, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• Deprecate the use of / for division. The new math.div() function should be used instead. See this page for details.

• Add a list.slash() function that returns a slash-separated list.

• Potentially breaking bug fix: The heuristics around when potentially slash-separated numbers are converted to slash-free numbers—for example, when 1/2 will be printed as 0.5 rather than 1/2—have been slightly expanded. Previously, a number would be made slash-free if it was passed as an argument to a user-defined function, but not to a built-in function. Now it will be made slash-free in both cases. This is a behavioral change, but it's unlikely to affect any real-world stylesheets.

• :is() now behaves identically to :matches().

• Fix a bug where non-integer numbers that were very close to integer values would be incorrectly formatted in CSS.

• Fix a bug where very small number and very large negative numbers would be incorrectly formatted in CSS.

JS API

• The this context for importers now has a fromImport field, which is true if the importer is being invoked from an @import and false otherwise. Importers should only use this to determine whether to load import-only files.

Dart API

• Add an Importer.fromImport getter, which is true if the current Importer.canonicalize() call comes from an @import rule and false otherwise. Importers should only use this to determine whether to load import-only files.

See the full changelog for changes in earlier releases.

To install Sass 1.32.13, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• Potentially breaking bug fix: Null values in @use and @forward configurations no longer override the !default variable, matching the behavior of the equivalent code using @import.

• Use the proper parameter names in error messages about string.slice

See the full changelog for changes in earlier releases.

To install Sass 1.32.12, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• Fix a bug that disallowed more than one module from extending the same selector from a module if that selector itself extended a selector from another upstream module.

See the full changelog for changes in earlier releases.

To install Sass 1.32.11, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• Fix a bug where bogus indented syntax errors were reported for lines that contained only whitespace.

See the full changelog for changes in earlier releases.

To install Sass 1.32.10, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• No user-visible changes.

See the full changelog for changes in earlier releases.

To install Sass 1.32.9, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• Fix a typo in a deprecation warning.

JavaScript API

• Drop support for Chokidar 2.x. This version was incompatible with Node 14, but due to shortcomings in npm's version resolver sometimes still ended up installed anyway. Only declaring support for 3.0.0 should ensure compatibility going forward.

Dart API

• Allow the null safety release of args and watcher.

Command Line Interface

• Add a -w shorthand for the --watch flag.

See the full changelog for changes in earlier releases.

To install Sass 1.32.8, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• Update chokidar version for Node API tests.

JavaScript API

• Allow a custom function to access the render() options object within its local context, as this.options.

See the full changelog for changes in earlier releases.

To install Sass 1.32.7, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• Allow the null safety release of stream_transform.

• Allow @forward...with to take arguments that have a !default flag without a trailing comma.

• Improve the performance of unitless and single-unit numbers.

See the full changelog for changes in earlier releases.

To install Sass 1.32.6, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

Node JS API

• Fix Electron support when nodeIntegration is disabled.

Dart API

• All range checks for SassColor constructors now throw RangeErrors with start and end set.

See the full changelog for changes in earlier releases.

To install Sass 1.32.5, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• Potentially breaking bug fix: When using @for with numbers that have units, the iteration variable now matches the unit of the initial number. This matches the behavior of Ruby Sass and LibSass.

Node JS API

• Fix a few infrequent errors when calling render() with fiber multiple times simultaneously.

• Avoid possible mangled error messages when custom functions or importers throw unexpected exceptions.

• Fix Electron support when nodeIntegration is disabled.

See the full changelog for changes in earlier releases.

To install Sass 1.32.4, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• No user-visible changes.

See the full changelog for changes in earlier releases.

To install Sass 1.32.3, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• Optimize == for numbers that have different units.

See the full changelog for changes in earlier releases.

To install Sass 1.32.2, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• Print the actual number that was received in unit deprecation warnings for color functions.

See the full changelog for changes in earlier releases.

To install Sass 1.32.1, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• Don't emit permissions errors on Windows and OS X when trying to determine the real case of path names.

See the full changelog for changes in earlier releases.

To install Sass 1.32.0, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• Deprecate passing non-% numbers as lightness and saturation to hsl(), hsla(), color.adjust(), and color.change(). This matches the CSS specification, which also requires % for all lightness and saturation parameters. See [the Sass website][color-units] for more details.

• Deprecate passing numbers with units other than deg as the hue to hsl(), hsla(), adjust-hue(), color.adjust(), and color.change(). Unitless numbers are still allowed here, since they're allowed by CSS. See [the Sass website][color-units] for more details.

• Improve error messages about incompatible units.

• Properly mark some warnings emitted by sass:color functions as deprecation warnings.

Dart API

• Rename SassNumber.valueInUnits() to SassNumber.coerceValue(). The old name remains, but is now deprecated.

• Rename SassNumber.coerceValueToUnit(), a shorthand for SassNumber.coerceValue() that takes a single numerator unit.

• Add SassNumber.coerceToMatch() and SassNumber.coerceValueToMatch(), which work like SassNumber.coerce() and SassNumber.coerceValue() but take a SassNumber whose units should be matched rather than taking the units explicitly. These generate better error messages than SassNumber.coerce() and SassNumber.coerceValue().

• Add SassNumber.convertToMatch() and SassNumber.convertValueToMatch(), which work like SassNumber.coerceToMatch() and SassNumber.coerceValueToMatch() except they throw exceptions when converting unitless values to or from units.

• Add SassNumber.compatibleWithUnit(), which returns whether the number can be coerced to a single numerator unit.

See the full changelog for changes in earlier releases.

To install Sass 1.30.0, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• Fix a bug where @at-root (without: all) wouldn't properly remove a @keyframes context when parsing selectors.

Node JS API

• The generated main() function in sass.js now returns a Promise that completes when the executable is finished running.

Dart API

• Fix a bug that prevented importers from returning null when loading from a URL that they had already canonicalized.

See the full changelog for changes in earlier releases.

To install Sass 1.29.0, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• Support a broader syntax for @supports conditions, based on the latest Editor's Draft of CSS Conditional Rules 3. Almost all syntax will be allowed (with interpolation) in the conditions' parentheses, as well as function syntax such as @supports selector(...).

See the full changelog for changes in earlier releases.

To install Sass 1.28.0, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• Add a color.hwb() function to sass:color that can express colors in HWB format.

• Add color.whiteness() and color.blackness() functions to sass:color to get a color's HWB whiteness and blackness components.

• Add $whiteness and $blackness parameters to color.adjust(), color.change(), and color.scale() to modify a color's HWB whiteness and blackness components.

Dart API

• Add HWB support to the SassColor class, including a SassColor.hwb() constructor, whiteness and blackness getters, and a changeHwb() method.

See the full changelog for changes in earlier releases.

To install Sass 1.27.2, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• No user-visible changes.

See the full changelog for changes in earlier releases.

• Potentially breaking bug fix: meta.load-css() now correctly uses the name $url for its first argument, rather than $module.

• Don't crash when using Infinity or NaN as a key in a map.

• Emit a proper parse error for a = with no right-hand side in a function.

• Avoid going exponential on certain recursive @extend edge cases.

To install Sass 1.27.0, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• Adds an overload to map.merge() that supports merging a nested map.

  map.merge($map1, $keys..., $map2): The $keys form a path to the nested map in $map1, into which $map2 gets merged.

  See the Sass documentation for more details.

• Adds an overloaded map.set() function.

  map.set($map, $key, $value): Adds to or updates $map with the specified $key and $value.

  map.set($map, $keys..., $value): Adds to or updates a map that is nested within $map. The $keys form a path to the nested map in $map, into which $value is inserted.

  See the Sass documentation for more details.

• Add support for nested maps to map.get(). For example, map.get((a: (b: (c: d))), a, b, c) would return d. See the documentation for more details.

• Add support for nested maps in map.has-key. For example, map.has-key((a: (b: (c: d))), a, b, c) would return true. See the documentation for more details.

• Add a map.deep-merge() function. This works like map.merge(), except that nested map values are also recursively merged. For example:

  map.deep-merge(
    (color: (primary: red, secondary: blue),
    (color: (secondary: teal)
  ) // => (color: (primary: red, secondary: teal))
  

  See the Sass documentation for more details.

• Add a map.deep-remove() function. This allows you to remove keys from nested maps by passing multiple keys. For example:

  map.deep-remove(
    (color: (primary: red, secondary: blue)),
    color, primary
  ) // => (color: (secondary: blue))
  

  See the Sass documentation for more details.

• Fix a bug where custom property values in plain CSS were being parsed as normal property values.

Dart API

• Add a Value.tryMap() function which returns the Value as a SassMap if it's a valid map, or null otherwise. This allows function authors to safely retrieve maps even if they're internally stored as empty lists, without having to catch exceptions from Value.assertMap().

See the full changelog for changes in earlier releases.

To install Sass 1.26.12, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• Fix a bug where nesting properties beneath a Sass-syntax custom property (written as #{--foo}: ...) would crash.

See the full changelog for changes in earlier releases.

To install Sass 1.26.11, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• Potentially breaking bug fix: selector.nest() now throws an error if the first arguments contains the parent selector &.

• Fixes a parsing bug with inline comments in selectors.

• Improve some error messages for edge-case parse failures.

• Throw a proper error when the same built-in module is @used twice.

• Don't crash when writing Infinity in JS mode.

• Produce a better error message for positional arguments following named arguments.

See the full changelog for changes in earlier releases.

To install Sass 1.26.10, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• Fixes a bug where two adjacent combinators could cause an error.

See the full changelog for changes in earlier releases.

To install Sass 1.26.9, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

To install Sass 1.26.8, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

To install Sass 1.26.7, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

To install Sass 1.26.6, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

To install Sass 1.26.5, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

To install Sass 1.26.3, download one of the packages below and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• More aggressively eliminate redundant selectors in the selector.extend() and selector.replace() functions.

See the full changelog for changes in earlier releases.

Command Line Interface

• Fix a longstanding bug where --watch mode could enter into a state where recompilation would not occur after a syntax error was introduced into a dependency and then fixed.

See the full changelog for changes in earlier releases.

• Potentially breaking bug fix: @use rules whose URLs' basenames begin with _ now correctly exclude that _ from the rules' namespaces.

• Fix a bug where imported forwarded members weren't visible in mixins and functions that were defined before the @import.

• Don't throw errors if the exact same member is loaded or forwarded from multiple modules at the same time.

See the full changelog for changes in earlier releases.

• No user-visible changes.

See the full changelog for changes in earlier releases.

• @use rules whose URLs' basenames begin with _ now correctly exclude that _ from the rules' namespaces.

• Fix a bug where imported forwarded members weren't visible in mixins and functions that were defined before the @import.

See the full changelog for changes in earlier releases.

• Don't throw errors if the exact same member is loaded or forwarded from multiple modules at the same time.

See the full changelog for changes in earlier releases.

To install Dart Sass 1.25.0, download one of the packages above and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• Add functions to the built-in "sass:math" module.

  • clamp($min, $number, $max). Clamps $number in between $min and $max.

  • hypot($numbers...). Given n numbers, outputs the length of the n-dimensional vector that has components equal to each of the inputs.

  • Exponential. All inputs must be unitless. * log($number) or log($number, $base). If no base is provided, performs a natural log. * pow($base, $exponent) * sqrt($number)

  • Trigonometric. The input must be an angle. If no unit is given, the input is assumed to be in rad. * cos($number) * sin($number) * tan($number)

  • Inverse trigonometric. The output is in deg. * acos($number). Input must be unitless. * asin($number). Input must be unitless. * atan($number). Input must be unitless. * atan2($y, $x). $y and $x must have compatible units or be unitless.

• Add the variables $pi and $e to the built-in "sass:math" module.

JavaScript API

• constructor.value fields on value objects now match their Node Sass equivalents.

See the full changelog for changes in earlier releases.

To install Dart Sass 1.24.5, download one of the packages above and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• Highlight contextually-relevant sections of the stylesheet in error messages, rather than only highlighting the section where the error was detected.

See the full changelog for changes in earlier releases.

To install Dart Sass 1.24.4, download one of the packages above and add it to your PATH, or see the Sass website for full installation instructions.

Changes

JavaScript API

• Fix a bug where source map generation would crash with an absolute source map path and a custom importer that returns string file contents.

See the full changelog for changes in earlier releases.

To install Dart Sass 1.24.3, download one of the packages above and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• Fix a bug where sass --version would crash for certain executable distributions.

See the full changelog for changes in earlier releases.

To install Dart Sass 1.24.2, download one of the packages above and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• Fix a bug introduced in the previous release that prevented custom importers in Node.js from loading import-only files.

See the full changelog for changes in earlier releases.

To install Dart Sass 1.24.1, download one of the packages above and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• Fix a bug where the wrong file could be loaded when the same URL is used by both a @use rule and an @import rule.

See the full changelog for changes in earlier releases.

To install Dart Sass 1.24.0, download one of the packages above and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• Add an optional with clause to the @forward rule. This works like the @use rule's with clause, except that @forward ... with can declare variables as !default to allow downstream modules to reconfigure their values.

• Support configuring modules through @import rules.

See the full changelog for changes in earlier releases.

To install Dart Sass 1.23.7, download one of the packages above and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• No user-visible changes.

See the full changelog for changes in earlier releases.

To install Dart Sass 1.23.6, download one of the packages above and add it to your PATH, or see the Sass website for full installation instructions.

Changes

• No user-visible changes.

See the full changelog for changes in earlier releases.