Skip to content

Localization

SD.Next localization system is based on the single JSON file: html/locale_en.json

The structure is simple: for each visible UI label, there is a corresponding hint displayed when the user hovers over the label.

Example: Generate button:

{"id":"","label":"Generate","localized":"","hint":"Start processing"}

Tip

See Hints document for more details

This file is auto-translated using an LLM model to create separate files in the format html/locale_{locale}.json. These auto-generated files should not be edited directly as they will be overwritten on the next update. For translation improvements, contact the maintainers.

Note

Translation is performed using the cli/localize.js script

Editing Localization

For poor translations or to provide better alternatives, create or edit html/override_{locale}.json. This file should include only the specific items you want to override.

Supported Languages

  • en: English
  • de: German
  • es: Spanish
  • fr: French
  • it: Italian
  • pt: Portuguese
  • hr: Croatian
  • zh: Chinese
  • ja: Japanese
  • ko: Korean
  • ru: Russian

If you want to add additional language, you can create a new file with the same structure and submit it as a PR, or contact us.

Selecting Locale

The default locale is auto-selected based on the browser's language settings.

You can manually select the locale in Settings → User Interface → Language.

Or use the CLI parameter --locale, for example:

./webui.sh --debug --locale hr

For testing purposes, quick-switch is also available by clicking near the top-right corner of the page