On this page

Profiling QML Applications

QML Profiler

With the QML Profiler you can analyze your QML code for performance performance issues. The profiler is part of both Qt Creator and Qt Design Studio. The best way to use it is to utilize {QC}'s or {QDS}'s defaults for build and run settings.

If you are building or running manually, in order to use the QML Profiler, you need to enable the QML debugging infrastructure.

Using the command line qmlprofiler tool

Qt provides the qmlprofiler command line tool to capture profiling data in a file. The file can later be loaded into Qt Creator or Qt Design Studio for analysis. It connects to the application using the debugging protocol.

To run this tool, after starting the application with the QML debugging infrastructure enabled, enter the following command:

qmlprofiler -p <port> -attach <ip address>

It is advisable to use the services argument to -qmljsdebugger in order to limit the debug infrastructure to only the services required. These are typically CanvasFrameRate, EngineControl, and DebugMessages. Having other services enabled may influence the profiling results.

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