Language Server Settings

This document describes the settings available in the Some Sass language server. For the VS Code extension, see the settings user guide.

Recommended settings

These are the recommended settings if you're just getting started.

{
	// Recommended if you don't rely on @import
	"somesass.scss.completion.suggestFromUseOnly": true,
	"somesass.sass.completion.suggestFromUseOnly": true,
}

Settings reference

You can configure similar settings for both SCSS, Sass (indented) and CSS. There are also some settings that apply to the workspace regardless of syntax.

Workspace

Id	Description	Default
`somesass.workspace.loadPaths`	A list of paths relative to the workspace root where the language server should look for stylesheets loaded by `@use` and `@import`. `node_modules` is always included. Note that you will have to configure your Sass compiler separately.	`[]`
`somesass.workspace.exclude`	List of glob patterns for directories that are excluded in the initial scan for Sass files. Files in the exclude list will still be processed if referenced by `@use`, `@forward` and `@import` (for example a depencendy you use from `node_modules`).	`["/.git/", "/node_modules/"]`
`somesass.workspace.logLevel`	Control how much gets logged to the Output window. Possible values are `"silent"`, `"fatal"`, `"error"`, `"warn"`, `"info"`, `"debug"` and `"trace"`.	`"info"`
`some-sass.trace.server`	Log the messages sent between VS Code and the Some Sass language server. Possible values are `"off"`, `"messages"` and `"verbose"`	`"off"`

SCSS

For brevity the ID column omits the somesass.scss prefix. For example, to use the setting codeAction.enabled use the ID somesass.scss.codeAction.enabled.

Id	Description	Default
`codeAction.enabled`	Enable or disable all code actions.	`true`
`colors.enabled`	Enable or disable all color decorators.	`true`
`colors.includeFromCurrentDocument`	Compatibility setting for VS Code. By default the built-in SCSS server shows color decorators for variables declared in the current document. To avoid duplicates Some Sass will not show them unless you opt in.	`true`
`completion.enabled`	Enable or disable all completions (IntelliSense).	`true`
`completion.includeFromCurrentDocument`	Compatibility setting for VS Code. By default the built-in SCSS server shows suggestions for variables, mixins and functions declared in the current document. To avoid duplicates Some Sass will not suggest them unless you opt in.	`true`
`completion.suggestFromUseOnly`	If your project uses the new module system with @use and @forward, you may want to only include suggestions from your used modules.	`false`
`completion.mixinStyle`	Controls the style of suggestions for mixins. Options are `"all"`, `"nobracket"` (only show suggestions without brackets) and `"bracket"` (where brackets are suggested, don't suggest without brackets).	`"all"`
`completion.triggerPropertyValueCompletion`	By default, Some Sass triggers property value completion after selecting a CSS property. Use this setting to disable this behavior.	`true`
`completion.completePropertyWithSemicolon`	Insert semicolon at end of line when completing CSS properties.	`true`
`definition.enabled`	Enable or disable Go to Definition.	`true`
`diagnostics.enabled`	Enable or disable all diagnostics (deprecation, errors and lint rules).	`true`
`diagnostics.deprecation.enabled`	Enable or disable deprecation diagnostics (strike-through).	`true`
`diagnostics.lint.enabled`	Enable or disable all linting.	`true`
`diagnostics.lint.*`	For the available lint rules and what they do, see the VS Code docs for CSS and SCSS lint settings
`documentSymbol.enabled`	Enable or disable document/editor symbols.	`true`
`foldingRanges.enabled`	Enable or disable folding ranges.	`true`
`highlights.enabled`	Enable or disable highlights.	`true`
`hover.enabled`	Enable or disable all hover information.	`true`
`hover.documentation`	Show property and value documentation in CSS hovers.	`true`
`hover.references`	Show references to MDN in CSS hovers, Sass documentation for Sass built-in modules and SassDoc for annotations.	`true`
`links.enabled`	Enable or disable the link provider that lets you click an import and open the file.	`true`
`references.enabled`	Enable or disable Find all references.	`true`
`rename.enabled`	Enable or disable Rename.	`true`
`selectionRanges.enabled`	Enable or disable selection ranges.	`true`
`signatureHelp.enabled`	Enable or disable signature help.	`true`
`workspaceSymbol.enabled`	Enable or disable workspace symbol.	`true`

Sass indented

For brevity the ID column omits the somesass.sass prefix. For example, to use the setting codeAction.enabled use the ID somesass.sass.codeAction.enabled.

Id	Description	Default
`codeAction.enabled`	Enable or disable all code actions.	`true`
`colors.enabled`	Enable or disable all color decorators.	`true`
`completion.enabled`	Enable or disable all completions (IntelliSense).	`true`
`completion.suggestFromUseOnly`	If your project uses the new module system with @use and @forward, you may want to only include suggestions from your used modules.	`false`
`completion.mixinStyle`	Controls the style of suggestions for mixins. Options are `"all"`, `"nobracket"` (only show suggestions without brackets) and `"bracket"` (where brackets are suggested, don't suggest without brackets).	`"all"`
`completion.triggerPropertyValueCompletion`	By default, Some Sass triggers property value completion after selecting a CSS property. Use this setting to disable this behavior.	`true`
`definition.enabled`	Enable or disable Go to Definition.	`true`
`diagnostics.enabled`	Enable or disable all diagnostics (deprecation, errors and lint rules).	`true`
`diagnostics.deprecation.enabled`	Enable or disable deprecation diagnostics (strike-through).	`true`
`diagnostics.lint.enabled`	Enable or disable all linting.	`true`
`diagnostics.lint.*`	For the available lint rules and what they do, see the VS Code docs for CSS and SCSS lint settings
`foldingRanges.enabled`	Enable or disable folding ranges.	`true`
`highlights.enabled`	Enable or disable highlights.	`true`
`hover.enabled`	Enable or disable all hover information.	`true`
`hover.documentation`	Show property and value documentation in CSS hovers.	`true`
`hover.references`	Show references to MDN in CSS hovers, Sass documentation for Sass built-in modules and SassDoc for annotations.	`true`
`links.enabled`	Enable or disable the link provider that lets you click an import and open the file.	`true`
`references.enabled`	Enable or disable Find all references.	`true`
`rename.enabled`	Enable or disable Rename.	`true`
`selectionRanges.enabled`	Enable or disable selection ranges.	`true`
`signatureHelp.enabled`	Enable or disable signature help.	`true`
`workspaceSymbol.enabled`	Enable or disable workspace symbol.	`true`

CSS

For brevity the ID column omits the somesass.css prefix. For example, to use the setting codeAction.enabled use the ID somesass.css.codeAction.enabled.

Id	Description	Default
`codeAction.enabled`	Enable or disable all code actions.	`true`
`colors.enabled`	Enable or disable all color decorators.	`true`
`completion.enabled`	Enable or disable all completions (IntelliSense).	`true`
`completion.triggerPropertyValueCompletion`	By default, Some Sass triggers property value completion after selecting a CSS property. Use this setting to disable this behavior.	`true`
`completion.completePropertyWithSemicolon`	Insert semicolon at end of line when completing CSS properties.	`true`
`definition.enabled`	Enable or disable Go to Definition.	`true`
`diagnostics.enabled`	Enable or disable all diagnostics (deprecation, errors and lint rules).	`true`
`diagnostics.deprecation.enabled`	Enable or disable deprecation diagnostics (strike-through).	`true`
`diagnostics.lint.enabled`	Enable or disable all linting.	`true`
`diagnostics.lint.*`	For the available lint rules and what they do, see the VS Code docs for CSS and SCSS lint settings
`foldingRanges.enabled`	Enable or disable folding ranges.	`true`
`highlights.enabled`	Enable or disable highlights.	`true`
`hover.enabled`	Enable or disable all hover information.	`true`
`hover.documentation`	Show property and value documentation in CSS hovers.	`true`
`hover.references`	Show references to MDN in CSS hovers, Sass documentation for Sass built-in modules and SassDoc for annotations.	`true`
`links.enabled`	Enable or disable the link provider that lets you click an import and open the file.	`true`
`references.enabled`	Enable or disable Find all references.	`true`
`rename.enabled`	Enable or disable Rename.	`true`
`selectionRanges.enabled`	Enable or disable selection ranges.	`true`
`signatureHelp.enabled`	Enable or disable signature help.	`true`
`workspaceSymbol.enabled`	Enable or disable workspace symbol.	`true`
`customData`	A list of relative file paths pointing to JSON files following the custom data format. Some Sass loads custom data on startup to enhance its CSS support for CSS custom properties (variables), at-rules, pseudo-classes, and pseudo-elements you specify in the JSON files. The file paths are relative to workspace and only workspace folder settings are considered.	`[]`