Selects the style of the Qt Quick Controls.


Qt Quick Controls is a module provided with Qt for MCUs. It offers a range of components that can be used by applications, such as buttons, sliders, etc. To make use of this module, a qmlproject-based project needs to import the module via a ModuleFiles node.

Qt for MCUs supports the styling of the controls. In a qmlproject context, this is achieved by implementing the new style in a separate module that itself imports the ControlsTemplates module. The new module needs to be imported in the main project, via the ModuleFiles node. In addition to that, the URI of this new module needs to be specified through this property, controlsStyle.

The property controlsStyle can be overridden from the command line. See --controls-style.

Note: This property applies to executable targets only


This property is accepted in the main application .qmlproject file, or a module .qmlproject file. It takes a string, and the default value is "QtQuick.Controls.StyleDefault".

Code example:

// customstyle.qmlproject
MCU.Module {
    uri: "MyApp.MyCustomStyle"

// mainproject.qmlproject
MCU.Config {
    controlsStyle: "MyApp.MyCustomStyle"


This property was introduced in QmlProject API 1.3 .


Available under certain Qt licenses.
Find out more.