diff --git a/src/gui/transferlistwidget.cpp b/src/gui/transferlistwidget.cpp
index fc7942148..6fb71bfaa 100644
--- a/src/gui/transferlistwidget.cpp
+++ b/src/gui/transferlistwidget.cpp
@@ -1448,6 +1448,8 @@ void TransferListWidget::openPreviewSelectDialog(const BitTorrent::Torrent *torr
 {
     auto *dialog = new PreviewSelectDialog(this, torrent);
     dialog->setAttribute(Qt::WA_DeleteOnClose);
+    // Qt::QueuedConnection is required to prevent a bug on wayland compositors where the preview won't open.
+    // It occurs when the window focus shifts immediately after TransferListWidget::previewFile has been called.
     connect(dialog, &PreviewSelectDialog::readyToPreviewFile, this, &TransferListWidget::previewFile, Qt::QueuedConnection);
     dialog->show();
 }