A directory containing QML files


This node can be used to list a directory containing the QML files, instead of listing all the QML file using the "files" node. It is a convenient alternative to add the QML sources, if all the files live in a single directory. If the QML sources are spread across different directories, several QmlFiles nodes can be used to list them.

Note: A QmlFiles node can contain one instance of "files" or "directory" nodes, or both. This property might be removed from future releases. Prefer explicit inclusion of files using the files property.

qmlprojectexporter scans the given directory for QML files, and adds them to the list of QML sources. It scans the directory for QML files and ignores the subdirectories in it. Several QmlFiles nodes can be used to list multiple directories that contain the QML sources.


This property is accepted in any context where its parent node is accepted. It takes a string.

Code example:

QmlFiles {
    directory: "custom/"


This property was introduced in QmlProject API 1.3 .

Available under certain Qt licenses.
Find out more.