diff --git a/kde-frameworks/kio/Manifest b/kde-frameworks/kio/Manifest
index 584920a98ea46..8f645d72b893e 100644
--- a/kde-frameworks/kio/Manifest
+++ b/kde-frameworks/kio/Manifest
@@ -1,3 +1,4 @@
 DIST kio-5.116.0.tar.xz 3800352 BLAKE2B 2197d92589bd6eba360a72fb1902bb1e97d48065834e762e681eb312797f8c54829ee6099e87f316de83913755572e7b9fe4aa1d168fa83ada519cce8980d030 SHA512 a07661717846860db3a64bcead9c2b80192d8c5b8e66a25f0f83ced6b596c4e8af7eb94e68b17770f45b36b22ccbcecaef4f8590d790cf69fceb140ab9e47376
 DIST kio-6.18.0.tar.xz 3490828 BLAKE2B ae76d814b8673534ca9506f9deb703d260f0fbab267851e9ed86d8cd4b0f272fd3b55b031486fce44dfe970d0b2f2ffb3eab5974d2ca67cf51ca2aed51c8105a SHA512 b291ee877f715668319f6ad7680c30f8f0f85b46fbb668c93d119ee6707a866d44bc4d209275e2887e4652b346b53f845fcf71dc8c886b925ddb9b0c453f881f
 DIST kio-6.20.0.tar.xz 3469560 BLAKE2B 6fe968f56fac1ed90b269006643718f774f9f49e4b692e5d66c8e40aa54b22cc28ea867a8a5e8044fa525b98919add0a69ccccf649e8f5f31e8007a0597641ad SHA512 4ecb3629fca599941299e1dd6be0bb2e478c976c7ad926387a0910848d876775924c88126a2379923e561a33a48bcd1f32283caf593ebed82167c75c93f25e12
+DIST kio-6.21.0.tar.xz 3479636 BLAKE2B 95d4917f1674adcb21a7866399c8e171de976fbbc424e9b8b6b50d05eca823cfed59ba66b985ef2d8cc2d18786eeb7103142c4ff1e9c8c868b9880ca4a8ded90 SHA512 5be71541a11ccab522d4a2de92eb5c3c207b925f2172c04003ba90a449418c6db3ef172bb57d549f430872e6c39c897223be6c22ed064afa1c808c18372c4388
diff --git a/kde-frameworks/kio/kio-6.21.0.ebuild b/kde-frameworks/kio/kio-6.21.0.ebuild
new file mode 100644
index 0000000000000..fe9ec67eba36a
--- /dev/null
+++ b/kde-frameworks/kio/kio-6.21.0.ebuild
@@ -0,0 +1,83 @@
+# Copyright 1999-2025 Gentoo Authors
+# Distributed under the terms of the GNU General Public License v2
+
+EAPI=8
+
+ECM_DESIGNERPLUGIN="true"
+ECM_HANDBOOK="optional"
+ECM_HANDBOOK_DIR="docs"
+ECM_TEST="forceoptional"
+QTMIN=6.8.1
+inherit ecm frameworks.kde.org xdg
+
+DESCRIPTION="Framework providing transparent file and data management"
+
+LICENSE="LGPL-2+"
+KEYWORDS="~amd64 ~arm64 ~loong ~ppc64 ~riscv ~x86"
+IUSE="acl +kwallet wayland X"
+
+# tests hang
+RESTRICT="test"
+
+# slot op: Uses Qt6::GuiPrivate for qtx11extras_p.h
+COMMON_DEPEND="
+	>=dev-qt/qtbase-${QTMIN}:6[dbus,gui,network,ssl,widgets,X?]
+	>=dev-qt/qtdeclarative-${QTMIN}:6
+	=kde-frameworks/kbookmarks-${KDE_CATV}*:6
+	=kde-frameworks/kcodecs-${KDE_CATV}*:6
+	=kde-frameworks/kcolorscheme-${KDE_CATV}*:6
+	=kde-frameworks/kcompletion-${KDE_CATV}*:6
+	=kde-frameworks/kconfig-${KDE_CATV}*:6
+	=kde-frameworks/kcoreaddons-${KDE_CATV}*:6
+	=kde-frameworks/kcrash-${KDE_CATV}*:6
+	=kde-frameworks/kdbusaddons-${KDE_CATV}*:6
+	=kde-frameworks/kguiaddons-${KDE_CATV}*:6
+	=kde-frameworks/ki18n-${KDE_CATV}*:6
+	=kde-frameworks/kiconthemes-${KDE_CATV}*:6
+	=kde-frameworks/kitemviews-${KDE_CATV}*:6
+	=kde-frameworks/kjobwidgets-${KDE_CATV}*:6
+	=kde-frameworks/knotifications-${KDE_CATV}*:6
+	=kde-frameworks/kservice-${KDE_CATV}*:6
+	=kde-frameworks/ktextwidgets-${KDE_CATV}*:6
+	=kde-frameworks/kwidgetsaddons-${KDE_CATV}*:6
+	=kde-frameworks/kwindowsystem-${KDE_CATV}*:6[wayland?,X?]
+	=kde-frameworks/solid-${KDE_CATV}*:6
+	sys-apps/util-linux
+	acl? (
+		sys-apps/attr
+		virtual/acl
+	)
+	handbook? (
+		dev-libs/libxml2:=
+		dev-libs/libxslt
+		=kde-frameworks/karchive-${KDE_CATV}*:6
+		=kde-frameworks/kdoctools-${KDE_CATV}*:6
+	)
+	kwallet? ( =kde-frameworks/kwallet-${KDE_CATV}*:6 )
+	X? ( >=dev-qt/qtbase-${QTMIN}:6=[gui] )
+"
+DEPEND="${COMMON_DEPEND}
+	>=dev-qt/qtbase-${QTMIN}:6[concurrent]
+"
+RDEPEND="${COMMON_DEPEND}
+	>=dev-qt/qtbase-${QTMIN}:6[libproxy]
+	sys-power/switcheroo-control
+"
+# bug 944812: File Properties is accessible from KFileWidget (KIO); this
+# provides access to keditfiletype binary via KWidgetsAddons (Tier1)
+# Typical KIO revdeps (dolphin, krusader et al.) can rely on this dep
+PDEPEND="
+	>=kde-frameworks/kded-${KDE_CATV}:6
+	kde-plasma/keditfiletype
+"
+
+src_configure() {
+	local mycmakeargs=(
+		$(cmake_use_find_package acl ACL)
+		$(cmake_use_find_package kwallet KF6Wallet)
+		-DWITH_WAYLAND=$(usex wayland)
+		-DWITH_X11=$(usex X)
+	)
+
+	ecm_src_configure
+}