Install & Compatibility
Where this runs
tested against v6.11.2 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.910 runs
build_error
glibcpy 3.10–3.910 runs
installs and imports cleanly · install 8.1s · import 0.000s · 669MB
662MB installed
● package 662MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
QWebEngineView
✓ from PySide6.QtWebEngineWidgets import QWebEngineView
QChartView
✓ from PySide6.QtCharts import QChartView
QMediaPlayer
✓ from PySide6.QtMultimedia import QMediaPlayer
Q3DScene
✓ from PySide6.Qt3DCore import Q3DScene
This quickstart demonstrates how to create a basic PySide6 application and integrate a component from `pyside6-addons`, specifically `QtCharts`, to display a simple line chart. Ensure `pyside6` is installed, which will bring in `pyside6-addons` as a dependency.
import sys
from PySide6.QtWidgets import QApplication, QMainWindow, QVBoxLayout, QWidget
from PySide6.QtCharts import QChartView, QLineSeries
from PySide6.QtCore import QPointF
class ChartWindow(QMainWindow):
def __init__(self):
super().__init__()
self.setWindowTitle("PySide6 Addons: QtCharts Example")
self.setGeometry(100, 100, 600, 400)
series = QLineSeries()
series.append(QPointF(0, 6))
series.append(QPointF(2, 4))
series.append(QPointF(3, 8))
series.append(QPointF(7, 4))
series.append(QPointF(10, 5))
chart = QChartView()
chart.chart().addSeries(series)
chart.chart().createDefaultAxes()
chart.chart().setTitle("Simple Line Chart")
central_widget = QWidget()
layout = QVBoxLayout(central_widget)
layout.addWidget(chart)
self.setCentralWidget(central_widget)
if __name__ == "__main__":
app = QApplication(sys.argv)
window = ChartWindow()
window.show()
sys.exit(app.exec())
Debug
Known issues
breaking`QAction` has moved from `PySide6.QtWidgets` to `PySide6.QtGui` since PySide6.0. Applications migrating from PySide2 or older PySide6 versions need to update their imports.fixChange `from PySide6.QtWidgets import QAction` to `from PySide6.QtGui import QAction`.
affects: >=6.0.0
breakingSome enum type names changed from plural to singular (e.g., `Qt.ItemFlags` to `Qt.ItemFlag`). This primarily affected migrations from PyQt6 v6.0 to v6.1, but PySide6 has adopted the singular form since v6.0, meaning older code might break.fixUpdate enum references, for example, `Qt.ItemFlags` becomes `Qt.ItemFlag`.
affects: >=6.0.0
deprecatedThe `setMargin()` method for `QLayout` objects has been deprecated. Use `setContentsMargins()` instead.fixReplace `layout.setMargin(value)` with `layout.setContentsMargins(left, top, right, bottom)` or `layout.setContentsMargins(QMargins(value, value, value, value))`.
affects: >=6.0.0
gotchaWhen upgrading PySide6 (especially from 6.2.x to 6.3.0 and later), `ModuleNotFoundError` can occur for modules that are now part of `pyside6-essentials` or `pyside6-addons`. This is often due to residual files from previous installations or cache issues.fixPerform a clean reinstallation: `pip uninstall pyside6 pyside6-addons pyside6-essentials shiboken6`, then `pip cache purge`, and finally `pip install pyside6`.
affects: >=6.3.0
gotchaUsers on Linux might encounter 'Could not load the Qt platform plugin "xcb"' errors after PySide6 upgrades (e.g., to 6.5), indicating a missing system dependency.fixInstall `libxcb-cursor0` (e.g., `sudo apt install libxcb-cursor0` on Debian/Ubuntu) and potentially other platform-specific missing libraries.
affects: >=6.5.0
gotchaImporting `QtWebEngineWidgets` (part of `pyside6-addons`) on Windows can sometimes result in `ImportError: DLL load failed while importing QtWebEngineWidgets: The specified module could not be found.` This often points to environmental conflicts or missing runtime components.fixTry using a fresh Python virtual environment. Ensure all PySide6-related packages (pyside6, pyside6-addons, shiboken6) are consistently installed. Check system PATH for conflicting Qt installations.
affects: All 6.x versions
breakingThe minimum supported Python version for PySide6 and its addons has been raised to Python 3.10.fixEnsure your Python environment is version 3.10 or newer.
affects: >=6.11.0
Errors
Common errors & fixes
ModuleNotFoundError: No module named 'PySide6.QtCharts'
The PySide6.QtCharts module is not part of the core PySide6 package and requires the pyside6-addons package to be installed.
fixpip install pyside6-addons
ModuleNotFoundError: No module named 'PySide6.QtWebEngineWidgets'
The PySide6.QtWebEngineWidgets module is not part of the core PySide6 package and requires the pyside6-addons package to be installed.
fixpip install pyside6-addons
ImportError: DLL load failed while importing QtWebEngineWidgets
This Windows-specific error indicates missing system-level runtime dependencies (e.g., Visual C++ Redistributable) required by the underlying QtWebEngine C++ libraries, even if pyside6-addons is installed.
fixEnsure the latest Visual C++ Redistributable is installed on your system. For Linux, a similar error might occur if system dependencies like libnss3 or libxkbcommon-x11-0 are missing.
ERROR: Could not find a version that satisfies the requirement pyside6-addons
This usually means a compatible pre-built wheel for your Python version and operating system is not available on PyPI, or a non-existent version was requested.
fixEnsure your Python environment is supported by available pyside6-addons wheels, upgrade pip (`python -m pip install --upgrade pip`), or check the official PyPI page for supported versions and platforms.
Upgrade
Version history
6.11.2latest on PyPI · released Aug 18, 2026
Audit
Dependencies
PySide6requiredThe core PySide6 package (which includes pyside6-essentials and shiboken6) is implicitly or explicitly required for pyside6-addons functionality.
shiboken6requiredEssential utility module for PySide6's Python-C++ bindings.
PySide6-EssentialsrequiredContains core Qt modules necessary for any PySide6 application.