How To Use Qss In Qt Project

We assume that you know the Qt API that allows users to customize their interface components (widgets) through a simple scripting language called Qt Style Sheets. which is based on the CSS syntax for HTML. If you do not know, we recommend that you start to get interested in this API by going to the official website of Qt.


You will have a file of the type .rar, an archive which bears the name of the chosen template (StyleEaxmple.rar). This archive contains:

-Style Example.qss : the file that contains the syntax of Qt Style Sheets customize and adaptable to all chosen graphic components.

-License.txt : contains the text of the license which authorizes the use of the file in the respect of the copyrights for the moment it is the license MIT.

-template.png : a preview on the result of the style sheets on the interface.

The qss file is compatible with all Qt applications (Qt4, Qt5, Py Side, Py Side2, Qt4 Py, Qt5 Py, Qt Py, PyQtGraph).

Usage In C++

External reading from file :

Load from resources (.qrc & .pro) : 

Change the path to the URL qrc, always started by ":/". 

To understand how the resource system works, please consult this link The Qt Resource System.

Usage In Python

Here is an example using PySide :

PyQt4 :

PyQt5, more lines need to be changed because of its API :

If your project uses QtPy :

It is also simple with PyQtGraph :

Useful Links : 

Qt | Cross-platform software :
Qt Pyside & Pyside 2 :
PyQt :
QtPy :
PyQtGraph - Scientific Graphics and GUI Library for Python :

New style sheets Every Month!

Subscribe to our email newsletter today to recieve updates on the latest news, tutorials and special offers! 



1 place de la Comédie
Montpellier Center


Press Room
Contact Us