Commit 75675a3fe97 for woocommerce

commit 75675a3fe976ef45d503de4d4c9d2cf5b48a79f1
Author: Brian Coords <bacoords@gmail.com>
Date:   Mon May 18 10:48:14 2026 -0700

    Update REST API documentation links to new location (#64720)

    * Update REST API documentation links to new location

    * Add changefile(s) from automation for the following project(s): @woocommerce/data, @woocommerce/components, woocommerce, woocommerce/client/admin

    * Fix markdown lint errors in JS package README files

    - Convert setext headings to ATX style
    - Wrap bare URLs in descriptive markdown links
    - Fix multiple H1 headings by using proper heading hierarchy
    - Remove trailing punctuation from headings
    - Fix table column alignment
    - Replace non-descriptive "[here]" link text with descriptive text

    Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

    * Apply suggestions from code review

    Co-authored-by: Darren Ethier <darren@roughsmootheng.in>

    * fix product category object example

    * fixes typo in shipping zones selector docs

    * fixes markdownlint issues

    * fix more markdown lint issues

    ---------

    Co-authored-by: woocommercebot <woocommercebot@users.noreply.github.com>
    Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
    Co-authored-by: Darren Ethier <darren@roughsmootheng.in>

diff --git a/.github/workflows/pr-highlight-rest-api-changes.yml b/.github/workflows/pr-highlight-rest-api-changes.yml
index dd9b5b41262..3af805c8dde 100644
--- a/.github/workflows/pr-highlight-rest-api-changes.yml
+++ b/.github/workflows/pr-highlight-rest-api-changes.yml
@@ -52,5 +52,5 @@ jobs:
               issue_number: context.payload.pull_request.number,
               owner: context.repo.owner,
               repo: context.repo.repo,
-              body: '⚠️ **API Documentation Reminder**\n\nHi @${{ github.event.pull_request.user.login }}! Your PR contains REST API changes. Please consider updating the [REST API documentation](https://github.com/woocommerce/woocommerce-rest-api-docs) if your changes affect the public API.\n\nChanged API files:\n```\n${{ join(fromJson(steps.filter.outputs.rest_files || '[]'), '\n') }}\n```'
+              body: '⚠️ **API Documentation Reminder**\n\nHi @${{ github.event.pull_request.user.login }}! Your PR contains REST API changes. Please consider updating the [REST API documentation](https://github.com/woocommerce/woocommerce/tree/trunk/docs/apis/rest-api) if your changes affect the public API.\n\nChanged API files:\n```\n${{ join(fromJson(steps.filter.outputs.rest_files || '[]'), '\n') }}\n```'
             });
diff --git a/packages/js/components/changelog/64720-fix-update-rest-api-docs-references b/packages/js/components/changelog/64720-fix-update-rest-api-docs-references
new file mode 100644
index 00000000000..9723af4780c
--- /dev/null
+++ b/packages/js/components/changelog/64720-fix-update-rest-api-docs-references
@@ -0,0 +1,4 @@
+Significance: patch
+Type: dev
+
+Updates internal references to REST API documentation.
\ No newline at end of file
diff --git a/packages/js/components/src/order-status/README.md b/packages/js/components/src/order-status/README.md
index 04417062fe3..4e5a9a7cd6e 100644
--- a/packages/js/components/src/order-status/README.md
+++ b/packages/js/components/src/order-status/README.md
@@ -1,5 +1,4 @@
-OrderStatus
-===
+# OrderStatus

 Use `OrderStatus` to display a badge with human-friendly text describing the current order status.

@@ -15,6 +14,6 @@ const order = { status: 'processing' }; // Use a real WooCommerce Order here.

 Name | Type | Default | Description
 --- | --- | --- | ---
-`order` | Object | `null` | (required) The order to display a status for. See: https://woocommerce.github.io/woocommerce-rest-api-docs/#order-properties
+`order` | Object | `null` | (required) The order to display a status for. See the [Order properties documentation](https://developer.woocommerce.com/docs/apis/rest-api/v3/orders/#order-properties).
 `className` | String | `null` | Additional CSS classes
 `orderStatusMap` | Object | {} | A map of order status to human-friendly label.
diff --git a/packages/js/components/src/product-image/README.md b/packages/js/components/src/product-image/README.md
index 79b9a89231d..4f074b0958f 100644
--- a/packages/js/components/src/product-image/README.md
+++ b/packages/js/components/src/product-image/README.md
@@ -1,5 +1,4 @@
-ProductImage
-===
+# ProductImage

 Use `ProductImage` to display a product's or variation's featured image.
 If no image can be found, a placeholder matching the front-end image
@@ -27,5 +26,5 @@ Name | Type | Default | Description
 `width` | Number | `60` | The width of image to display
 `height` | Number | `60` | The height of image to display
 `className` | String | `''` | Additional CSS classes
-`product` | Object | `null` | Product or variation object. The image to display will be pulled from `product.images` or `variation.image`. See https://woocommerce.github.io/woocommerce-rest-api-docs/#product-properties and https://woocommerce.github.io/woocommerce-rest-api-docs/#product-variation-properties
+`product` | Object | `null` | Product or variation object. The image to display will be pulled from `product.images` or `variation.image`. See [Product properties](https://developer.woocommerce.com/docs/apis/rest-api/v3/products/#product-properties) and [Product variation properties](https://developer.woocommerce.com/docs/apis/rest-api/v3/product-variations/#product-variation-properties).
 `alt` | String | `null` | Text to use as the image alt attribute
diff --git a/packages/js/components/src/product-image/index.tsx b/packages/js/components/src/product-image/index.tsx
index e8ea2bf5737..987cf406bfd 100644
--- a/packages/js/components/src/product-image/index.tsx
+++ b/packages/js/components/src/product-image/index.tsx
@@ -19,8 +19,8 @@ type ProductImageProps = {
 	/**
 	 * Product or variation object. The image to display will be pulled from
 	 * `product.images` or `variation.image`.
-	 * See https://woocommerce.github.io/woocommerce-rest-api-docs/#product-properties
-	 * and https://woocommerce.github.io/woocommerce-rest-api-docs/#product-variation-properties
+	 * See https://developer.woocommerce.com/docs/apis/rest-api/v3/products/#product-properties
+	 * and https://developer.woocommerce.com/docs/apis/rest-api/v3/product-variations/#product-variation-properties
 	 */
 	product?: {
 		images?: Array< Image >;
diff --git a/packages/js/components/src/rating/README.md b/packages/js/components/src/rating/README.md
index 929d94396b1..8b056c35cd3 100644
--- a/packages/js/components/src/rating/README.md
+++ b/packages/js/components/src/rating/README.md
@@ -1,5 +1,4 @@
-Rating
-===
+# Rating

 Use `Rating` to display a set of stars, filled, empty or half-filled, that represents a
 rating in a scale between 0 and the prop `totalStars` (default 5).
@@ -20,12 +19,11 @@ Name | Type | Default | Description
 `className` | String | `null` | Additional CSS classes


-ProductRating
-===
+## ProductRating

 Display a set of stars representing the product's average rating.

-## Usage
+### Usage

 ```jsx
 // Use a real WooCommerce Product here.
@@ -38,15 +36,14 @@ const product = { average_rating: 3.5 };

 Name | Type | Default | Description
 --- | --- | --- | ---
-`product` | Object | `null` | (required) A product object containing a `average_rating`. See https://woocommerce.github.io/woocommerce-rest-api-docs/#products
+`product` | Object | `null` | (required) A product object containing a `average_rating`. See the [Products API documentation](https://developer.woocommerce.com/docs/apis/rest-api/v3/products/).


-ReviewRating
-===
+## ReviewRating

 Display a set of stars representing the review's rating.

-## Usage
+### Usage

 ```jsx
 // Use a real WooCommerce Review here.
@@ -59,4 +56,4 @@ const review = { rating: 5 };

 Name | Type | Default | Description
 --- | --- | --- | ---
-`review` | Object | `null` | (required) A review object containing a `rating`. See https://woocommerce.github.io/woocommerce-rest-api-docs/#retrieve-product-reviews
+`review` | Object | `null` | (required) A review object containing a `rating`. See the [Product Reviews API documentation](https://developer.woocommerce.com/docs/apis/rest-api/v3/product-reviews/#retrieve-a-product-review).
diff --git a/packages/js/components/src/rating/review.tsx b/packages/js/components/src/rating/review.tsx
index e812f683ee1..e0e47748eef 100644
--- a/packages/js/components/src/rating/review.tsx
+++ b/packages/js/components/src/rating/review.tsx
@@ -11,7 +11,7 @@ import Rating from './index';
 type ReviewRatingProps = {
 	/**
 	 * A review object containing a `rating`.
-	 * See https://woocommerce.github.io/woocommerce-rest-api-docs/#retrieve-product-reviews.
+	 * See https://developer.woocommerce.com/docs/apis/rest-api/v3/product-reviews/#retrieve-a-product-review .
 	 */
 	review: {
 		rating?: number;
diff --git a/packages/js/data/changelog/64720-fix-update-rest-api-docs-references b/packages/js/data/changelog/64720-fix-update-rest-api-docs-references
new file mode 100644
index 00000000000..9723af4780c
--- /dev/null
+++ b/packages/js/data/changelog/64720-fix-update-rest-api-docs-references
@@ -0,0 +1,4 @@
+Significance: patch
+Type: dev
+
+Updates internal references to REST API documentation.
\ No newline at end of file
diff --git a/packages/js/data/src/product-categories/README.md b/packages/js/data/src/product-categories/README.md
index 9c2e2ec6ca8..bb63f5d9a93 100644
--- a/packages/js/data/src/product-categories/README.md
+++ b/packages/js/data/src/product-categories/README.md
@@ -1,6 +1,6 @@
 # Product Categories Data Store

-This data store provides functions to interact with the [Product Category REST endpoints](https://woocommerce.github.io/woocommerce-rest-api-docs/#product-categories).
+This data store provides functions to interact with the [Product Category REST endpoints](https://developer.woocommerce.com/docs/apis/rest-api/v3/product-categories/).
 Under the hood this data store makes use of the [CRUD data store](../crud/README.md).

 **Note: This data store is listed as experimental still as it is still in active development.**
@@ -23,21 +23,21 @@ function Component() {
 }
 ```

-## Selections and actions:
+## Selections and actions

-| Selector                                       | Description                                                                                            |
-| ---------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
-| `getProductCategory( id: number )`        | Gets a Product Category by ID                                                                    |
-| `getProductCategoryError( id )`           | Get the error for a failing GET product category request.                                        |
-| `getProductCategories( query = {} )`      | Get all product categories, optionally by a specific query, see `Query` type [here](./types.ts). |
-| `getProductCategoriesError( query = {} )` | Get the error for a GET request for all categories.                                              |
+| Selector                                  | Description                                                                                                        |
+| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
+| `getProductCategory( id: number )`        | Gets a Product Category by ID                                                                                      |
+| `getProductCategoryError( id )`           | Get the error for a failing GET product category request.                                                          |
+| `getProductCategories( query = {} )`      | Get all product categories, optionally by a specific query, see `Query` type in [types.ts](./types.ts).            |
+| `getProductCategoriesError( query = {} )` | Get the error for a GET request for all categories.                                                                |

 Example usage: `wp.data.select( EXPERIMENTAL_PRODUCT_CATEGORIES_STORE_NAME ).getProductCategory( 3 );`

-| Actions                                                  | Method | Description                                                                        |
-| -------------------------------------------------------- | ------ | ---------------------------------------------------------------------------------- |
-| `createProductCategory( shippingClassObject )`      | POST   | Create product category, see `ProductCategory` [here](./types.ts) for values   |
-| `deleteProductCategory( id )`                       | DELETE | Delete a product category by ID                                                |
-| `updatetProductCategory( id, shippingClassObject )` | PUT    | Update a product category, see `ProductCategory` [here](./types.ts) for values |
+| Actions                                              | Method | Description                                                                           |
+| ---------------------------------------------------- | ------ | ------------------------------------------------------------------------------------- |
+| `createProductCategory( productCategoryObject )`     | POST   | Create product category, see `ProductCategory` in [types.ts](./types.ts) for values   |
+| `deleteProductCategory( id )`                        | DELETE | Delete a product category by ID                                                       |
+| `updateProductCategory( id, productCategoryObject )` | PUT    | Update a product category, see `ProductCategory` in [types.ts](./types.ts) for values |

 Example usage: `wp.data.dispatch( EXPERIMENTAL_PRODUCT_CATEGORIES_STORE_NAME ).updateProductCategory( 3, { name: 'New name' } );`
diff --git a/packages/js/data/src/product-shipping-classes/README.md b/packages/js/data/src/product-shipping-classes/README.md
index bf9f6e50063..bef61e767ac 100644
--- a/packages/js/data/src/product-shipping-classes/README.md
+++ b/packages/js/data/src/product-shipping-classes/README.md
@@ -1,6 +1,6 @@
 # Product Shipping Classes Data Store

-This data store provides functions to interact with the [Product Shipping Class REST endpoints](https://woocommerce.github.io/woocommerce-rest-api-docs/#product-shipping-classes).
+This data store provides functions to interact with the [Product Shipping Class REST endpoints](https://developer.woocommerce.com/docs/apis/rest-api/v3/product-shipping-classes/).
 Under the hood this data store makes use of the [CRUD data store](../crud/README.md).

 **Note: This data store is listed as experimental still as it is still in active development.**
@@ -23,21 +23,21 @@ function Component() {
 }
 ```

-## Selections and actions:
+## Selections and actions

-| Selector                                       | Description                                                                                            |
-| ---------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
-| `getProductShippingClass( id: number )`        | Gets a Product Shipping Class by ID                                                                    |
-| `getProductShippingClassError( id )`           | Get the error for a failing GET shipping class request.                                                |
-| `getProductShippingClasses( query = {} )`      | Get all product shipping classes, optionally by a specific query, see `Query` type [here](./types.ts). |
-| `getProductShippingClassesError( query = {} )` | Get the error for a GET request for all shipping classes.                                              |
+| Selector                                       | Description                                                                                                   |
+| ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
+| `getProductShippingClass( id: number )`        | Gets a Product Shipping Class by ID                                                                           |
+| `getProductShippingClassError( id )`           | Get the error for a failing GET shipping class request.                                                       |
+| `getProductShippingClasses( query = {} )`      | Get all product shipping classes, optionally by a specific query, see `Query` type in [types.ts](./types.ts). |
+| `getProductShippingClassesError( query = {} )` | Get the error for a GET request for all shipping classes.                                                     |

 Example usage: `wp.data.select( EXPERIMENTAL_PRODUCT_SHIPPING_CLASSES_STORE_NAME ).getProductShippingClass( 3 );`

-| Actions                                                  | Method | Description                                                                        |
-| -------------------------------------------------------- | ------ | ---------------------------------------------------------------------------------- |
-| `createProductShippingClass( shippingClassObject )`      | POST   | Creates shipping class, see `ProductShippingClass` [here](./types.ts) for values   |
-| `deleteProductShippingClass( id )`                       | DELETE | Deletes a shipping class by ID                                                     |
-| `updatetProductShippingClass( id, shippingClassObject )` | PUT    | Updates a shipping class, see `ProductShippingClass` [here](./types.ts) for values |
+| Actions                                                 | Method | Description                                                                               |
+| ------------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------- |
+| `createProductShippingClass( shippingClassObject )`     | POST   | Creates shipping class, see `ProductShippingClass` in [types.ts](./types.ts) for values   |
+| `deleteProductShippingClass( id )`                      | DELETE | Deletes a shipping class by ID                                                            |
+| `updateProductShippingClass( id, shippingClassObject )` | PUT    | Updates a shipping class, see `ProductShippingClass` in [types.ts](./types.ts) for values |

 Example usage: `wp.data.dispatch( EXPERIMENTAL_PRODUCT_SHIPPING_CLASSES_STORE_NAME ).updateProductShippingClass( 3, { name: 'New name' } );`
diff --git a/packages/js/data/src/shipping-zones/README.md b/packages/js/data/src/shipping-zones/README.md
index 4ff3a406330..877d9ff3cc3 100644
--- a/packages/js/data/src/shipping-zones/README.md
+++ b/packages/js/data/src/shipping-zones/README.md
@@ -1,6 +1,6 @@
 # Shipping Zones Data Store

-This data store provides functions to interact with the [Shipping Zones REST endpoints](https://woocommerce.github.io/woocommerce-rest-api-docs/#shipping-zones).
+This data store provides functions to interact with the [Shipping Zones REST endpoints](https://developer.woocommerce.com/docs/apis/rest-api/v3/shipping-zones/).
 Under the hood this data store makes use of the [CRUD data store](../crud/README.md).

 **Note: This data store is listed as experimental still as it is still in active development.**
@@ -27,19 +27,19 @@ function Component() {

 ## Selections and actions

-| Selector                               | Description                                             |
-| -------------------------------------- | ------------------------------------------------------- |
-| `getShippingZone( id: number )`        | Gets a Shipping Zone by ID                              |
-| `getShippingZoneError( id )`           | Get the error for a failing GET shipping zone request.  |
-| `getShippingZones( query = {} )`       | Get all shipping zones, query object is empty.          |
-| `getShippingZoneesError( query = {} )` | Get the error for a GET request for all shipping zones. |
+| Selector                              | Description                                             |
+| ------------------------------------- | ------------------------------------------------------- |
+| `getShippingZone( id: number )`       | Gets a Shipping Zone by ID                              |
+| `getShippingZoneError( id )`          | Get the error for a failing GET shipping zone request.  |
+| `getShippingZones( query = {} )`      | Get all shipping zones, query object is empty.          |
+| `getShippingZonesError( query = {} )` | Get the error for a GET request for all shipping zones. |

 Example usage: `wp.data.select( experimentalShippingZonesStore ).getShippingZone( 3 );`

-| Actions                                         | Method | Description                                                               |
-| ----------------------------------------------- | ------ | ------------------------------------------------------------------------- |
-| `createShippingZone( shippingZoneObject )`      | POST   | Creates shipping zone, see `ShippingZone` [here](./types.ts) for values   |
-| `deleteShippingZone( id )`                      | DELETE | Deletes a shipping class by ID                                            |
-| `updatetShippingZone( id, shippingZoneObject )` | PUT    | Updates a shipping zone, see `ShippingZone` [here](./types.ts) for values |
+| Actions                                        | Method | Description                                                                      |
+| ---------------------------------------------- | ------ | -------------------------------------------------------------------------------- |
+| `createShippingZone( shippingZoneObject )`     | POST   | Creates shipping zone, see `ShippingZone` in [types.ts](./types.ts) for values   |
+| `deleteShippingZone( id )`                     | DELETE | Deletes a shipping zone by ID                                                    |
+| `updateShippingZone( id, shippingZoneObject )` | PUT    | Updates a shipping zone, see `ShippingZone` in [types.ts](./types.ts) for values |

 Example usage: `wp.data.dispatch( experimentalShippingZonesStore ).updateShippingZone( 3, { name: 'New name' } );`
diff --git a/plugins/woocommerce/README.md b/plugins/woocommerce/README.md
index 16a4930ad26..a044ee3bb87 100644
--- a/plugins/woocommerce/README.md
+++ b/plugins/woocommerce/README.md
@@ -96,7 +96,7 @@ PHPStan configuration is stored in `phpstan.neon` at the root of the plugin dire
 -   [WooCommerce Documentation](https://woocommerce.com/)
 -   [WooCommerce Developer Documentation](https://github.com/woocommerce/woocommerce/wiki)
 -   [WooCommerce Code Reference](https://woocommerce.com/wc-apidocs/)
--   [WooCommerce REST API Docs](https://woocommerce.github.io/woocommerce-rest-api-docs/)
+-   [WooCommerce REST API Docs](https://developer.woocommerce.com/docs/apis/rest-api/)

 ## A Note for Extension Developers

diff --git a/plugins/woocommerce/changelog/64720-fix-update-rest-api-docs-references b/plugins/woocommerce/changelog/64720-fix-update-rest-api-docs-references
new file mode 100644
index 00000000000..9723af4780c
--- /dev/null
+++ b/plugins/woocommerce/changelog/64720-fix-update-rest-api-docs-references
@@ -0,0 +1,4 @@
+Significance: patch
+Type: dev
+
+Updates internal references to REST API documentation.
\ No newline at end of file
diff --git a/plugins/woocommerce/client/admin/client/utils/admin-settings.js b/plugins/woocommerce/client/admin/client/utils/admin-settings.js
index b4e5b393638..b7e0b01b963 100644
--- a/plugins/woocommerce/client/admin/client/utils/admin-settings.js
+++ b/plugins/woocommerce/client/admin/client/utils/admin-settings.js
@@ -27,7 +27,7 @@ export const deprecatedAdminProperties = {
 		profile:
 			'Deprecated: wcSettings.admin.onboarding.profile is deprecated. It is planned to be released in WooCommerce 10.0.0. Please use `getProfileItems` from the onboarding store. See https://github.com/woocommerce/woocommerce/tree/trunk/packages/js/data/src/onboarding for more information.',
 		euCountries:
-			'Deprecated: wcSettings.admin.onboarding.euCountries is deprecated. Please use `/wc/v3/data/continents/eu` from the REST API. See https://woocommerce.github.io/woocommerce-rest-api-docs/#list-all-continents for more information.',
+			'Deprecated: wcSettings.admin.onboarding.euCountries is deprecated. Please use `/wc/v3/data/continents/eu` from the REST API. See https://developer.woocommerce.com/docs/apis/rest-api/v3/data/#list-all-continents for more information.',
 		localInfo:
 			'Deprecated: wcSettings.admin.onboarding.localInfo is deprecated. Please use `include WC()->plugin_path() . "/i18n/locale-info.php"` instead.',
 		currencySymbols:
diff --git a/plugins/woocommerce/readme.txt b/plugins/woocommerce/readme.txt
index a569044a8f4..e27a47c5448 100644
--- a/plugins/woocommerce/readme.txt
+++ b/plugins/woocommerce/readme.txt
@@ -132,7 +132,7 @@ Yes, you can! Join in on our [GitHub repository](https://github.com/woocommerce/

 = Where can I find REST API documentation? =

-Extensive [WooCommerce REST API Documentation](https://woocommerce.github.io/woocommerce-rest-api-docs/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing) is available on GitHub.
+Extensive [WooCommerce REST API Documentation](https://developer.woocommerce.com/docs/apis/rest-api/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=wp_org_repo_listing) is available.

 = My question is not listed here. Where can I find more answers? =

diff --git a/plugins/woocommerce/src/Admin/API/Options.php b/plugins/woocommerce/src/Admin/API/Options.php
index 4bc4408e5ae..12bdd0c5558 100644
--- a/plugins/woocommerce/src/Admin/API/Options.php
+++ b/plugins/woocommerce/src/Admin/API/Options.php
@@ -5,7 +5,7 @@
  * Handles requests to get and update options in the wp_options table.
  *
  * IMPORTANT: This API is for legacy support only. DO NOT add new options here. See p90Yrv-2vK-p2#comment-6482 for more details.
- * For new settings/options, use Settings REST API (https://woocommerce.github.io/woocommerce-rest-api-docs/#setting-option-properties) or create dedicated endpoints instead.
+ * For new settings/options, use Settings REST API (https://developer.woocommerce.com/docs/apis/rest-api/v3/setting-options/#setting-option-properties) or create dedicated endpoints instead.
  *
  * Example:
  * - Use register_rest_route() to create a new endpoint
diff --git a/plugins/woocommerce/tests/e2e-pw/data/coupon.ts b/plugins/woocommerce/tests/e2e-pw/data/coupon.ts
index 28c2c12365c..da10f4b1b42 100644
--- a/plugins/woocommerce/tests/e2e-pw/data/coupon.ts
+++ b/plugins/woocommerce/tests/e2e-pw/data/coupon.ts
@@ -3,7 +3,7 @@
  *
  * For more details on a coupon's properties, see:
  *
- * https://woocommerce.github.io/woocommerce-rest-api-docs/#coupons
+ * https://developer.woocommerce.com/docs/apis/rest-api/v3/coupons/
  *
  */
 export const coupon = {
diff --git a/plugins/woocommerce/tests/e2e-pw/data/order.ts b/plugins/woocommerce/tests/e2e-pw/data/order.ts
index 47f2fd88b48..6e4ab15ce58 100644
--- a/plugins/woocommerce/tests/e2e-pw/data/order.ts
+++ b/plugins/woocommerce/tests/e2e-pw/data/order.ts
@@ -12,7 +12,7 @@ import {
  *
  * For more details on the order properties, see:
  *
- * https://woocommerce.github.io/woocommerce-rest-api-docs/#order-properties
+ * https://developer.woocommerce.com/docs/apis/rest-api/v3/orders/#order-properties
  */
 export const order = {
 	payment_method: '',
diff --git a/plugins/woocommerce/tests/e2e-pw/data/products-crud.ts b/plugins/woocommerce/tests/e2e-pw/data/products-crud.ts
index 57d1ecc063b..7d8a15e9df1 100644
--- a/plugins/woocommerce/tests/e2e-pw/data/products-crud.ts
+++ b/plugins/woocommerce/tests/e2e-pw/data/products-crud.ts
@@ -3,7 +3,7 @@
  *
  * For more details on the Product properties, see:
  *
- * https://woocommerce.github.io/woocommerce-rest-api-docs/#products
+ * https://developer.woocommerce.com/docs/apis/rest-api/v3/products/
  *
  */

diff --git a/plugins/woocommerce/tests/e2e-pw/data/refund.ts b/plugins/woocommerce/tests/e2e-pw/data/refund.ts
index 07e57e1a9a7..79be43a8293 100644
--- a/plugins/woocommerce/tests/e2e-pw/data/refund.ts
+++ b/plugins/woocommerce/tests/e2e-pw/data/refund.ts
@@ -3,7 +3,7 @@
  *
  * For more details on the order refund properties, see:
  *
- * https://woocommerce.github.io/woocommerce-rest-api-docs/#order-refund-properties
+ * https://developer.woocommerce.com/docs/apis/rest-api/v3/order-refunds/#order-refund-properties
  *
  */
 export const refund = {
diff --git a/plugins/woocommerce/tests/e2e-pw/data/settings.ts b/plugins/woocommerce/tests/e2e-pw/data/settings.ts
index fb50470c015..c7f63f1f1f5 100644
--- a/plugins/woocommerce/tests/e2e-pw/data/settings.ts
+++ b/plugins/woocommerce/tests/e2e-pw/data/settings.ts
@@ -3,7 +3,7 @@
  *
  * For more details on settings properties, see:
  *
- * https://woocommerce.github.io/woocommerce-rest-api-docs/#settings
+ * https://developer.woocommerce.com/docs/apis/rest-api/v3/settings/
  *
  */

diff --git a/plugins/woocommerce/tests/e2e-pw/data/shared/customer.ts b/plugins/woocommerce/tests/e2e-pw/data/shared/customer.ts
index 04890975356..41903b504ce 100644
--- a/plugins/woocommerce/tests/e2e-pw/data/shared/customer.ts
+++ b/plugins/woocommerce/tests/e2e-pw/data/shared/customer.ts
@@ -2,8 +2,8 @@
  * Customer billing object.
  *
  * Used in the following APIs:
- * https://woocommerce.github.io/woocommerce-rest-api-docs/#customers
- * https://woocommerce.github.io/woocommerce-rest-api-docs/#orders
+ * https://developer.woocommerce.com/docs/apis/rest-api/v3/customers/
+ * https://developer.woocommerce.com/docs/apis/rest-api/v3/orders/
  */
 export const customerBilling = {
 	first_name: 'John',
@@ -37,8 +37,8 @@ export const customerBillingSearchTest = {
  * Customer shipping object.
  *
  * Used in the following APIs:
- * https://woocommerce.github.io/woocommerce-rest-api-docs/#customers
- * https://woocommerce.github.io/woocommerce-rest-api-docs/#orders
+ * https://developer.woocommerce.com/docs/apis/rest-api/v3/customers/
+ * https://developer.woocommerce.com/docs/apis/rest-api/v3/orders/
  */
 export const customerShipping = {
 	first_name: 'Tim',
diff --git a/plugins/woocommerce/tests/e2e-pw/data/shared/error-response.ts b/plugins/woocommerce/tests/e2e-pw/data/shared/error-response.ts
index 3ea957b24ff..90635b7a005 100644
--- a/plugins/woocommerce/tests/e2e-pw/data/shared/error-response.ts
+++ b/plugins/woocommerce/tests/e2e-pw/data/shared/error-response.ts
@@ -1,7 +1,7 @@
 /**
  * API error response format
  *
- * https://woocommerce.github.io/woocommerce-rest-api-docs/#errors
+ * https://developer.woocommerce.com/docs/apis/rest-api/#errors
  */
 export const errorResponse = {
 	code: '',
diff --git a/plugins/woocommerce/tests/e2e-pw/data/shipping-zone.ts b/plugins/woocommerce/tests/e2e-pw/data/shipping-zone.ts
index 0d79e95cbc1..2275b2ad738 100644
--- a/plugins/woocommerce/tests/e2e-pw/data/shipping-zone.ts
+++ b/plugins/woocommerce/tests/e2e-pw/data/shipping-zone.ts
@@ -3,7 +3,7 @@
  *
  * For more details on shipping zone properties, see:
  *
- * https://woocommerce.github.io/woocommerce-rest-api-docs/#shipping-zone-properties
+ * https://developer.woocommerce.com/docs/apis/rest-api/v3/shipping-zones/#shipping-zone-properties
  *
  */
 const shippingZone = {
diff --git a/plugins/woocommerce/tests/e2e-pw/data/tax-rate.ts b/plugins/woocommerce/tests/e2e-pw/data/tax-rate.ts
index f4af574ae5a..8ae66d1ac6b 100644
--- a/plugins/woocommerce/tests/e2e-pw/data/tax-rate.ts
+++ b/plugins/woocommerce/tests/e2e-pw/data/tax-rate.ts
@@ -3,7 +3,7 @@
  *
  * For more details on the tax rate properties, see:
  *
- * https://woocommerce.github.io/woocommerce-rest-api-docs/#tax-rate-properties
+ * https://developer.woocommerce.com/docs/apis/rest-api/v3/taxes/#tax-rate-properties
  *
  */
 const standardTaxRate = {
diff --git a/plugins/woocommerce/tests/e2e-pw/data/variation.ts b/plugins/woocommerce/tests/e2e-pw/data/variation.ts
index 24abae7c8e4..4bf5ba9fa88 100644
--- a/plugins/woocommerce/tests/e2e-pw/data/variation.ts
+++ b/plugins/woocommerce/tests/e2e-pw/data/variation.ts
@@ -3,7 +3,7 @@
  *
  * For more details on the product variation properties, see:
  *
- * https://woocommerce.github.io/woocommerce-rest-api-docs/#product-variations
+ * https://developer.woocommerce.com/docs/apis/rest-api/v3/product-variations/
  *
  */
 const variation = {
diff --git a/plugins/woocommerce/tests/e2e-pw/utils/api.ts b/plugins/woocommerce/tests/e2e-pw/utils/api.ts
index 74f728c8833..e72be856101 100644
--- a/plugins/woocommerce/tests/e2e-pw/utils/api.ts
+++ b/plugins/woocommerce/tests/e2e-pw/utils/api.ts
@@ -133,9 +133,9 @@ export const create = {
 	/**
 	 * Batch create product variations.
 	 *
-	 * @see {@link [Batch update product variations](https://woocommerce.github.io/woocommerce-rest-api-docs/#batch-update-product-variations)}
+	 * @see {@link [Batch update product variations](https://developer.woocommerce.com/docs/apis/rest-api/v3/product-variations/#batch-update-product-variations)}
 	 * @param {number|string} productId  Product ID to add variations to
-	 * @param {object[]}      variations Array of variations to add. See [Product variation properties](https://woocommerce.github.io/woocommerce-rest-api-docs/#product-variation-properties)
+	 * @param {object[]}      variations Array of variations to add. See [Product variation properties](https://developer.woocommerce.com/docs/apis/rest-api/v3/product-variations/#product-variation-properties)
 	 * @return {Promise<number[]>} Array of variation ID's.
 	 */
 	productVariations: async (
diff --git a/plugins/woocommerce/tests/e2e-pw/utils/variable-products.ts b/plugins/woocommerce/tests/e2e-pw/utils/variable-products.ts
index 63966d13b9e..7f86f9fca82 100644
--- a/plugins/woocommerce/tests/e2e-pw/utils/variable-products.ts
+++ b/plugins/woocommerce/tests/e2e-pw/utils/variable-products.ts
@@ -28,7 +28,7 @@ const productIds: number[] = [];
 /**
  * The `attributes` property to be used in the request payload for creating a variable product through the REST API.
  *
- * @see {@link [Product - Attributes properties](https://woocommerce.github.io/woocommerce-rest-api-docs/#product-attributes-properties)}
+ * @see {@link [Product - Attributes properties](https://developer.woocommerce.com/docs/apis/rest-api/v3/products/#product---attributes-properties)}
  */
 const productAttributes = [
 	{
@@ -54,7 +54,7 @@ const productAttributes = [
 /**
  * Request payload for creating variations.
  *
- * @see {@link [Product variation properties](https://woocommerce.github.io/woocommerce-rest-api-docs/#product-variation-properties)}
+ * @see {@link [Product variation properties](https://developer.woocommerce.com/docs/apis/rest-api/v3/product-variations/#product-variation-properties)}
  */
 const sampleVariations = [
 	{
@@ -113,7 +113,7 @@ const sampleVariations = [
 /**
  * Create a variable product using the WooCommerce REST API.
  *
- * @param {{ name: string, visible: boolean, variation: boolean, options: string[] }[]} attributes List of attributes. See [Product - Attributes properties](https://woocommerce.github.io/woocommerce-rest-api-docs/#product-attributes-properties).
+ * @param {{ name: string, visible: boolean, variation: boolean, options: string[] }[]} attributes List of attributes. See [Product - Attributes properties](https://developer.woocommerce.com/docs/apis/rest-api/v3/products/#product---attributes-properties).
  * @return {Promise<number>} ID of the created variable product
  */
 async function createVariableProduct( attributes: ProductAttribute[] = [] ) {