PyQt5 - Background Image to unchecked indicator in Check Box

Last Updated : 28 Apr, 2025

In this article we will see how to set background image to a indicator for unchecked check box. By default there is no background image set to the indicator. In order to set background image to the indicator for only unchecked state we have to change the style sheet of the indicator for unchecked state. Below is the style sheet code.

QCheckBox::indicator:unchecked
{
background-image : url(image.png);
}

Below is the implementation.

Python3

# importing libraries
from PyQt5.QtWidgets import * 
from PyQt5 import QtCore, QtGui
from PyQt5.QtGui import * 
from PyQt5.QtCore import * 
import sys


class Window(QMainWindow):

    def __init__(self):
        super().__init__()

        # setting title
        self.setWindowTitle("Python ")

        # setting geometry
        self.setGeometry(100, 100, 600, 400)

        # calling method
        self.UiComponents()

        # showing all the widgets
        self.show()

    # method for widgets
    def UiComponents(self):
        # creating the check-box
        checkbox = QCheckBox('Geek ?', self)

        # setting geometry of check box
        checkbox.setGeometry(200, 150, 100, 60)

        # changing size of indicator
        # adding background image to the indicator
        # when it is in unchecked state
        checkbox.setStyleSheet("QCheckBox::indicator"
                               "{"
                               "width : 60px;"
                               "height : 60px;"
                               "}"
                               "QCheckBox::indicator:unchecked"
                               "{"
                               "background-image : url(indicator_image.png);"
                               "width : 60px;"
                               "height : 60px;"
                               "}")


# create pyqt5 app
App = QApplication(sys.argv)

# create the instance of our Window
window = Window()

# start the app
sys.exit(App.exec())