Commit e2d18a35bfa for woocommerce
commit e2d18a35bfa7886c5962ad85d19eb29fe77d81ab
Author: Cem Ünalan <raicem@users.noreply.github.com>
Date: Mon Oct 5 09:46:12 2026 +0300
Add a Learn more link to the My Subscriptions connect screen (#69144)
* WOOMKT-824: Add a Learn more link to the My Subscriptions connect screen
The empty state only offered Connect and assumed the merchant already
had a WooCommerce.com account. Mention account creation in the copy and
add a secondary Learn more button that opens the connect-your-site doc.
* WOOMKT-824: Mark the Learn more link as opening in a new tab
Add the external icon and visually hidden "(opens in a new tab)" text so
sighted and screen reader users both know the doc opens in a new tab.
This matches the account link in the marketplace header.
---------
Co-authored-by: Herman <KokkieH@users.noreply.github.com>
diff --git a/plugins/woocommerce/changelog/WOOMKT-824 b/plugins/woocommerce/changelog/WOOMKT-824
new file mode 100644
index 00000000000..36c6b80a347
--- /dev/null
+++ b/plugins/woocommerce/changelog/WOOMKT-824
@@ -0,0 +1,4 @@
+Significance: patch
+Type: tweak
+
+Add a "Learn more" link to the My Subscriptions connect screen and mention creating a WooCommerce.com account.
diff --git a/plugins/woocommerce/client/admin/client/marketplace/components/constants.ts b/plugins/woocommerce/client/admin/client/marketplace/components/constants.ts
index cb70c9b2e0e..3fa58a46562 100644
--- a/plugins/woocommerce/client/admin/client/marketplace/components/constants.ts
+++ b/plugins/woocommerce/client/admin/client/marketplace/components/constants.ts
@@ -26,6 +26,9 @@ export const MARKETPLACE_COLLABORATION_PATH =
export const MARKETPLACE_SHARING_PATH =
MARKETPLACE_HOST +
'/document/managing-woocommerce-com-subscriptions/#share-a-subscription';
+export const MARKETPLACE_CONNECT_DOCS_PATH =
+ MARKETPLACE_HOST +
+ '/document/managing-woocommerce-com-subscriptions/connect-your-site-to-woocommerce-com/';
export const WP_ADMIN_PLUGIN_LIST_URL = ADMIN_URL + 'plugins.php';
export const WOO_CONNECT_PLUGIN_DOWNLOAD_URL =
MARKETPLACE_HOST + '/product-download/woo-update-manager';
diff --git a/plugins/woocommerce/client/admin/client/marketplace/components/my-subscriptions/my-subscriptions.scss b/plugins/woocommerce/client/admin/client/marketplace/components/my-subscriptions/my-subscriptions.scss
index 664804c0080..48f52fca1c1 100644
--- a/plugins/woocommerce/client/admin/client/marketplace/components/my-subscriptions/my-subscriptions.scss
+++ b/plugins/woocommerce/client/admin/client/marketplace/components/my-subscriptions/my-subscriptions.scss
@@ -371,6 +371,13 @@
margin-bottom: $grid-unit-30;
max-width: 520px;
}
+
+ .woocommerce-marketplace__my-subscriptions__connect-actions {
+ display: flex;
+ flex-wrap: wrap;
+ justify-content: center;
+ gap: $grid-unit-10;
+ }
}
.woocommerce-marketplace__my-subscriptions__table__header--actions {
diff --git a/plugins/woocommerce/client/admin/client/marketplace/components/my-subscriptions/my-subscriptions.tsx b/plugins/woocommerce/client/admin/client/marketplace/components/my-subscriptions/my-subscriptions.tsx
index 5d25a75c1a7..34e2ffe3d3f 100644
--- a/plugins/woocommerce/client/admin/client/marketplace/components/my-subscriptions/my-subscriptions.tsx
+++ b/plugins/woocommerce/client/admin/client/marketplace/components/my-subscriptions/my-subscriptions.tsx
@@ -1,7 +1,7 @@
/**
* External dependencies
*/
-import { Button } from '@wordpress/components';
+import { Button, VisuallyHidden } from '@wordpress/components';
import { __ } from '@wordpress/i18n';
import {
createInterpolateElement,
@@ -34,6 +34,7 @@ import {
} from '../../contexts/types';
import Notice from '../notice/notice';
import MySubscriptionsAccount from './my-subscriptions-account';
+import { MARKETPLACE_CONNECT_DOCS_PATH } from '../constants';
/**
* Whether the failure captured at page load has already been reported.
@@ -117,7 +118,7 @@ export default function MySubscriptions(): React.JSX.Element {
if ( ! wccomSettings?.isConnected ) {
const connectMessage = __(
- 'Connect your WooCommerce.com account to get product updates, manage your subscriptions from your store admin, and get streamlined support.',
+ 'Create and connect your WooCommerce.com account to get product updates, manage your subscriptions from your store admin, and get streamlined support.',
'woocommerce'
);
@@ -160,9 +161,25 @@ export default function MySubscriptions(): React.JSX.Element {
<p className="woocommerce-marketplace__my-subscriptions__description">
{ connectMessage }
</p>
- <Button href={ connectUrl() } variant="primary">
- { __( 'Connect', 'woocommerce' ) }
- </Button>
+ <div className="woocommerce-marketplace__my-subscriptions__connect-actions">
+ <Button href={ connectUrl() } variant="primary">
+ { __( 'Connect', 'woocommerce' ) }
+ </Button>
+ <Button
+ href={ MARKETPLACE_CONNECT_DOCS_PATH }
+ target="_blank"
+ rel="noopener noreferrer"
+ variant="secondary"
+ icon={ external }
+ iconSize={ 16 }
+ iconPosition="right"
+ >
+ { __( 'Learn more', 'woocommerce' ) }
+ <VisuallyHidden as="span">
+ { __( '(opens in a new tab)', 'woocommerce' ) }
+ </VisuallyHidden>
+ </Button>
+ </div>
</div>
</>
);