CMake Variable Reference

Module variables

Qt modules loaded with find_package set various variables.

Note: You rarely need to access these variables directly. Common tasks like linking against a module should be done through the library targets each module defines.

For example, find_package(Qt6 COMPONENTS Widgets), when successful, makes the following variables available:

Qt6Widgets_COMPILE_DEFINITIONSA list of compile definitions to use when building against the library.
Qt6Widgets_DEFINITIONSA list of definitions to use when building against the library.
Qt6Widgets_EXECUTABLE_COMPILE_FLAGSA string of flags to use when building executables against the library.
Qt6Widgets_FOUNDA boolean that describes whether the module was found successfully.
Qt6Widgets_INCLUDE_DIRSA list of include directories to use when building against the library.
Qt6Widgets_LIBRARIESThe name of the imported target for the module: Qt5::Widgets
Qt6Widgets_PRIVATE_INCLUDE_DIRSA list of private include directories to use when building against the library and using private Qt API.
Qt6Widgets_VERSION_STRINGA string containing the module's version.

For all packages found with find_package, equivalents of these variables are available; they are case-sensitive.

Installation variables

Additionally, there are also variables that don't relate to a particular package, but to the Qt installation itself.



An integer that controls the Qt version that qt_ commands forward to in case of mixed Qt 5 and Qt 6 projects. It needs to be set to either 5 or 6 before the respective find_package() calls.

If set to 5, commands starting with qt_ will call their counterpart starting with qt5_. If set to 6, they will call their counterpart starting with qt6_.

If not set, the first find_package call defines the default version.

QT_LIBINFIXA string that holds the infix used in library names, when Qt is configured with -libinfix.


Hides commands that start with qt_, leaving only the versioned ones starting with qt6_.


Hides the imported targets starting with Qt::. Instead, you need to use the targets starting with Qt6::.
QT_VISIBILITY_AVAILABLEOn Unix, a boolean that describes whether Qt libraries and plugins were compiled with -fvisibility=hidden. This means that only selected symbols are exported.

Project variables

These variables can influence CMake commands provided by Qt. They may be set by the project, a toolchain file or other third-party packages.



Android-specific architecture of the host system


Location of the Android SDK


List of arguments to pass to Android applications


Location of the host Qt installation when cross-compiling


Disables providing a fallback app bundle ID during target finalization on iOS


Disables providing a fallback team ID during target finalization on iOS



Base output directory below which QML modules will be created by default



Enable verbose logging for all ifcodegen functions


Search path for ifcodegen templates

© 2024 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.