Qt Quick Controls 2

Qt Quick Controls 2 provides a set of controls that can be used to build complete interfaces in Qt Quick. The module was introduced in Qt 5.7.

Qt Quick Controls 2 comes with a selection customizable styles. See Styling Qt Quick Controls 2 for more details.


The QML types can be imported into your application using the following import statement in your .qml file:

import QtQuick.Controls 2.4

The C++ classes can be included into your application using the following include statement:

#include <QtQuickControls2>

To link against the corresponding C++ libraries, add the following to your qmake project file:

QT += quickcontrols2

For more details, see Getting Started with Qt Quick Controls 2.

Building From Source

When building from source, ensure that the Qt Graphical Effects module is also built, as Qt Quick Controls 2 requires it.

The Qt Image Formats module is recommended, but not required. It provides support for the .webp format used by the Imagine style.


Qt Quick Controls 2.0 was introduced in Qt 5.7. Subsequent minor Qt releases increment the import version of the Qt Quick Controls 2 modules by one. The experimental Qt Labs modules use import version 1.0.

Qt QtQuick QtQuick.Controls,
5.7 2.7 2.0 1.0
5.8 2.8 2.1 1.0
5.9 2.9 2.2 1.0
5.10 2.10 2.3 1.0
5.11 2.11 2.4 1.0
... ... ... ...

License and Attributions

Qt Quick Controls 2 is available under commercial licenses from The Qt Company. In addition, it is available under the GNU Lesser General Public License, version 3, or the GNU General Public License, version 2. See Qt Licensing for further details.

Furthermore Qt Quick Controls 2 potentially contains third party modules under following permissive licenses:




Voted #1 for:

  • Easiest to learn
  • Most time saving
  • Best support

Develop Cross-Platform Apps and Games 50% Faster!

  • Voted the best supported, most time-saving and easiest to learn cross-platform development tool
  • Based on the Qt framework, with native performance and appearance on all platforms including iOS and Android
  • Offers a variety of plugins to monetize, analyze and engage users
create apps
create games
cross platform
native performance
3rd party services
game network
level editor
easiest to learn
biggest time saving
best support