The files in the given directory are added to the project. Subdirectories are ignored. If the font files are spread across different directories, several FontFiles nodes are needed, one for each directory or subdirectory that is intended to be added.

It is recommended to use the files property to explicitly add font files to the project, instead of including an entire directory. The contents of the given directory are not filtered, every file is added to project.

Refer to font formats for supported font file formats.


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

Code example:

FontFiles {
    directory: "libs/fonts"


  • The directory property can be combined with the files property in a FontFiles node.
  • We recommend using the files property to explicitly list the files, so that files added to the project is known beforehand.


This property was introduced in QmlProject API 1.3 .

See also FontFiles.files.

Available under certain Qt licenses.
Find out more.