On this page

Import file selector

This warning category is spelled [import-file-selector] by qmllint.

This category is disabled by default due to current limitations in QML tooling towards QML modules with file selectors.

Warnings occurred while importing

What happened?

The QML tooling found ambiguous types in an imported module due to file selector usages in the imported module. The QML runtime selects the appropriate file based on a runtime configuration, while the QML tooling has no information on which file will be selected, creating the ambiguity.

Why is that bad?

QML tooling can't use the import: the compiler can't compile this file to C++ and qmllint as well as QML Language Server can't provide useful warnings on that file.

© 2026 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.