- Qt 6.8
- Qt Quick Controls
- Supported Environment Variables in Qt Quick Controls
- Qt 6.8.3 Reference Documentation

# Supported Environment Variables in Qt Quick Controls

This page contains a list of all environment variables that Qt Quick Controls supports. The environment variables are primarily meant for testing purposes, but they can also be used to set system-wide defaults.

Variable | Description
--- | ---
`QT_QUICK_CONTROLS_STYLE` | Specifies the default Qt Quick Controls style. The value can be either one of the built-in styles, for example `"Material"`, or a custom style such as `"MyStyle"`.
`QT_QUICK_CONTROLS_FALLBACK_STYLE` | Specifies a fallback style for custom styles. The value can be one of the built-in styles, for example `"Material"`,
`QT_QUICK_CONTROLS_CONF` | Specifies the location of the Qt Quick Controls configuration file. By default, the configuration file is loaded from the application's resources in `":/qtquickcontrols2.conf"`.
`QT_QUICK_CONTROLS_HOVER_ENABLED` | Specifies whether Qt Quick Controls use hover effects. The value can be set to `0` or `1` to disable or enable hover effects, respectively.

Imagine style specific environment variables:

Variable | Description
--- | ---

`QT_QUICK_CONTROLS_IMAGINE_PATH`

Specifies the path to the directory that contains the Imagine style assets. If not specified, the built-in assets are used.

For example, to specify a path to a directory stored in the resource system:

     QT_QUICK_CONTROLS_IMAGINE_PATH=:/imagine-assets

To specify a relative path to a local directory:

     QT_QUICK_CONTROLS_IMAGINE_PATH=imagine-assets

Note: Due to a technical limitation, the path should not be named "imagine" if it is relative to the `qtquickcontrols2.conf` file.

`QT_QUICK_CONTROLS_IMAGINE_SMOOTH` | Set to `1` to enable smooth scaling for 9-patch images. This environment variable was added in Qt 6.5.

Material style specific environment variables:

Variable | Description
--- | ---
`QT_QUICK_CONTROLS_MATERIAL_THEME` | Specifies the default Material theme. The value can be one of the available themes, for example `"Dark"`.
`QT_QUICK_CONTROLS_MATERIAL_VARIANT` | Specifies the Material variant. The Material Design has two variants: a normal variant designed for touch devices, and a dense variant for desktop. The dense variant uses smaller sizes for controls and their fonts. The value can be `"Normal"` or `"Dense"`.
`QT_QUICK_CONTROLS_MATERIAL_ACCENT` | Specifies the default Material accent color. The value can be any color, but it is recommended to use one of the pre-defined Material colors, for example `"Teal"`.
`QT_QUICK_CONTROLS_MATERIAL_PRIMARY` | Specifies the default Material primary color. The value can be any color, but it is recommended to use one of the pre-defined Material colors, for example `"BlueGrey"`.
`QT_QUICK_CONTROLS_MATERIAL_FOREGROUND` | Specifies the default Material foreground color. The value can be any color, or one of the pre-defined Material colors, for example `"Brown"`.
`QT_QUICK_CONTROLS_MATERIAL_BACKGROUND` | Specifies the default Material background color. The value can be any color, or one of the pre-defined Material colors, for example `"Grey"`.

Universal style specific environment variables:

Variable | Description
--- | ---
`QT_QUICK_CONTROLS_UNIVERSAL_THEME` | Specifies the default Universal theme. The value can be one of the available themes, for example `"Dark"`.
`QT_QUICK_CONTROLS_UNIVERSAL_ACCENT` | Specifies the default Universal accent color. The value can be any color, but it is recommended to use one of the pre-defined Universal colors, for example `"Violet"`.
`QT_QUICK_CONTROLS_UNIVERSAL_FOREGROUND` | Specifies the default Universal foreground color. The value can be any color, or one of the pre-defined Universal colors, for example `"Brown"`.
`QT_QUICK_CONTROLS_UNIVERSAL_BACKGROUND` | Specifies the default Universal background color. The value can be any color, or one of the pre-defined Universal colors, for example `"Steel"`.

## Related Information

- Styling Qt Quick Controls
- Qt Quick Controls Configuration File