From 0071b59886365f0d8060cea8bb7019a100ba0740 Mon Sep 17 00:00:00 2001
From: Luke Holder <lukemh@gmail.com>
Date: Thu, 30 Apr 2026 09:56:01 +0800
Subject: [PATCH] Add deprecation warning to Commerce 5.x subscriptions docs

---
 docs/commerce/5.x/system/subscriptions.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/commerce/5.x/system/subscriptions.md b/docs/commerce/5.x/system/subscriptions.md
index 8bf4e023f..50785f56c 100644
--- a/docs/commerce/5.x/system/subscriptions.md
+++ b/docs/commerce/5.x/system/subscriptions.md
@@ -4,6 +4,10 @@ containsGeneratedContent: yes
 
 # Subscriptions
 
+::: warning
+Subscriptions are being removed in an upcoming release of Commerce. We recommend migrating to subscriptions managed by the [Stripe plugin](https://github.com/craftcms/stripe#migrating-from-craft-commerce).
+:::
+
 Commerce supports recurring revenue via _subscriptions_, a feature of [some gateways](#capabilities).
 
 Once you’ve added a payment gateway that supports subscriptions, navigate to <Journey path="Commerce, Subscription Plans" /> to set up one or more _plans_.