Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/SemanticWebLanguageServer/swls-vscode/llms.txt

Use this file to discover all available pages before exploring further.

All SWLS settings live under the swls prefix and can be configured through the VS Code Settings UI (Preferences: Open Settings (UI)) or directly in your settings.json file. Workspace-scoped settings in .vscode/settings.json take precedence over user-level settings, which is useful for per-project configurations.

All settings

SettingTypeDefaultDescription
swls.commandstring""Path to the swls binary. If empty, the bundled binary in the extension directory is used.
swls.checkUpdatebooleantrueCheck for new releases from GitHub.
swls.automaticUpdatebooleanfalseAutomatically install new updates.
swls.logstring"debug"Log level for the language server. One of: error, warn, info, debug, trace.
swls.turtlebooleantrueEnable Turtle Language.
swls.trigbooleantrueEnable TriG Language.
swls.jsonldbooleantrueEnable JSON-LD Language.
swls.sparqlbooleanfalseEnable SPARQL Language.
swls.ontologiesstring[][]Extra ontology URLs to import.
swls.shapesstring[][]Extra shape URLs to import.
swls.disabledstring[][]Features to disable (e.g. "shapes").
swls.prefixDisabledstring[][]Prefixes from prefix.cc to hide from completions.
swls.completion.modestring"none"Property completion mode: none (server default), loose (all properties), strict (domain-matched only).
swls.completion.strictstring[][]Namespace prefixes that require a matching domain (used when mode is loose to selectively enforce strictness). Takes precedence over mode.
swls.completion.exceptstring[][]Namespace prefixes that are always suggested regardless of domain (used when mode is strict to selectively relax strictness). Takes precedence over mode.

Key settings in detail

swls.command
string
default:"\"\""
Path to a custom swls binary. Leave empty to use the binary bundled with the extension. If no bundled binary exists, the extension automatically falls back to the WASM worker so the LSP is available immediately. Set this if you want to pin a specific binary version or use a self-compiled build.
swls.log
string
default:"\"debug\""
Controls how verbose the language server’s log output is. Accepted values in ascending verbosity order: error, warn, info, debug, trace. Log output appears in the Output panel under the swls channel (use the dropdown in the Output panel to switch to it). For day-to-day use, warn or info reduces noise; use trace when filing a bug report.
swls.completion.mode
string
default:"\"none\""
Governs which properties appear in completion suggestions for a given subject node. none defers to the server’s built-in behaviour; loose shows all known properties regardless of rdfs:domain; strict filters suggestions to properties whose rdfs:domain matches the subject’s declared rdf:type. See Completion Modes for a full walkthrough.
swls.disabled
string[]
default:"[]"
Array of feature identifiers to turn off. The only accepted value today is "shapes", which disables SHACL validation globally. Useful when you have shape files loaded via swls.shapes but want to temporarily mute diagnostics without removing the URLs.

Example configuration

A typical settings.json block that enables SPARQL, quiets the log, adds Schema.org as an ontology, and enables strict completions:
{
  "swls.sparql": true,
  "swls.log": "warn",
  "swls.ontologies": ["https://schema.org/version/latest/schemaorg-current-https.ttl"],
  "swls.shapes": ["https://example.org/shapes.ttl"],
  "swls.completion.mode": "strict"
}

Viewing log output

Log messages from the language server are written to the Output panel in VS Code. Open it with View → Output (or Ctrl+Shift+U / Cmd+Shift+U) and select swls from the channel dropdown on the right. Individual sub-components also emit to named channels like swls::debug.

Build docs developers (and LLMs) love