Commit 74d67b788db for woocommerce
commit 74d67b788db40275bb70105ee44087a9f153ab43
Author: darcie <318285+darcie@users.noreply.github.com>
Date: Wed Mar 11 07:13:10 2026 -0700
Fix URLs in Marketplace docs (#63625)
* Fix URLs in Marketplace docs
Updated links in the Marketplace docs to reflect current URLs.
* Update product submission link in billing API docs
* Change links to relative paths in getting started guide
Updated links in the getting started guide to use relative paths for better navigation.
* Fix links in managing-products.md
Updated links in the managing products documentation to point to internal resources.
* Update changelog link to point to correct documentation
Updated link and moving FAQs to the submitting instructions
* Update links and guidelines in documentation
* Changed relative URL from md to published destination
* Update HPOS recipe book URL and duplicate links for theme development
* Update docs/woo-marketplace/submitting-your-product.mdx
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
* Update docs/woo-marketplace/submitting-your-product.mdx
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
---------
Co-authored-by: Adrian <adrian.labos@automattic.com>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
diff --git a/docs/woo-marketplace/billing-api-saas.mdx b/docs/woo-marketplace/billing-api-saas.mdx
index e5f4bb39dc8..46ab5b93aa5 100644
--- a/docs/woo-marketplace/billing-api-saas.mdx
+++ b/docs/woo-marketplace/billing-api-saas.mdx
@@ -17,7 +17,7 @@ Follow this guide to get your billing powered by WooCommerce's world-class billi
To complete integrating WooCommerce Billing into your SaaS app, you'll need a sandbox and the API reference. The various API flows are described below.
-To get started, please [submit your product](https://woocommerce.com/document/submitting-your-product-to-the-woo-marketplace/) to the WooCommerce Marketplace. Include details about your product and upload a zip file to test whether your product utilizes a WordPress plugin to connect to your app. We will review your product to determine if it is a good fit before granting sandbox access.
+To get started, please [submit your product](/docs/woo-marketplace/submitting-your-product/) to the WooCommerce Marketplace. Include details about your product and upload a zip file to test whether your product utilizes a WordPress plugin to connect to your app. We will review your product to determine if it is a good fit before granting sandbox access.
### Sandbox for testing
diff --git a/docs/woo-marketplace/content-style-guide.md b/docs/woo-marketplace/content-style-guide.md
index 2c0bbcc0393..b672bdb7bb4 100644
--- a/docs/woo-marketplace/content-style-guide.md
+++ b/docs/woo-marketplace/content-style-guide.md
@@ -15,11 +15,11 @@ For product page structure, required elements, and asset specifications, refer t
Use the format "Product Name for WooCommerce" rather than "WooCommerce Product Name" throughout the product copy.
-This format ensures your product name complies with [trademark rules](https://automattic.com/trademark-policy/) and leads with its unique identifier, improving discoverability and clarity.
+This format ensures your product name complies with [trademark rules](https://woocommerce.com/trademark-guidelines/) and leads with its unique identifier, improving discoverability and clarity.
### Grammar and Punctuation
-Follow the [WooCommerce Grammar, Punctuation, and Capitalization Guide](https://woocommerce.com/document/woocommerce-grammar-punctuation-and-capitalization-guide/) for comprehensive guidance. Key points include:
+Follow the [WooCommerce grammar, punctuation, and capitalization guide](/docs/best-practices/coding-standards/grammar-punctuation-capitalization/) for comprehensive guidance. Key points include:
**Use the Oxford comma** when listing three or more items:
@@ -207,7 +207,7 @@ When creating documentation for your product, follow these additional guidelines
- Document all your product's features and settings
- Provide troubleshooting guidance for common issues
-For detailed documentation frameworks, refer to [Support and Documentation Best Practices](https://woocommerce.com/document/extension-development-best-practices/#support-and-documentation).
+For detailed documentation frameworks, refer to [Support and Documentation Best Practices](/docs/extensions/best-practices-extensions/support-and-documentation/).
### Images and Screenshots
diff --git a/docs/woo-marketplace/getting-started.md b/docs/woo-marketplace/getting-started.md
index 064c9fcd4e9..8c74b6baed9 100644
--- a/docs/woo-marketplace/getting-started.md
+++ b/docs/woo-marketplace/getting-started.md
@@ -20,7 +20,7 @@ We are looking for products that:
- Solve real merchant problems
- Are secure, well-documented, and well-maintained
-- Follow [security](https://developer.wordpress.org/apis/security/), [development](https://developer.woocommerce.com/docs/extensions/best-practices-extensions/extension-development-best-practices/), and [user experience](https://developer.woocommerce.com/docs/extensions/ux-guidelines-extensions/best-practices/) best practices
+- Follow [security](https://developer.wordpress.org/apis/security/), [development](/docs/extensions/best-practices-extensions/extension-development-best-practices/), and [user experience](/docs/extensions/ux-guidelines-extensions/best-practices/) best practices
- Offer high-quality merchant support
- Include a clear and sustainable monetization model, whether through direct sales, subscriptions, or another approach
@@ -35,8 +35,8 @@ To join the WooCommerce Marketplace, vendors must offer high-quality, secure pro
### Step 1: Prepare your product
1. Build and thoroughly test your extension or theme.
-2. Ensure it meets our [technical](https://developer.woocommerce.com/docs/extensions/best-practices-extensions/extension-development-best-practices/), [user experience](https://developer.woocommerce.com/docs/extensions/ux-guidelines-extensions/best-practices/) (UX), and [security standards](https://developer.wordpress.org/apis/security/).
-3. Write clear and comprehensive [documentation](https://developer.woocommerce.com/docs/extensions/best-practices-extensions/support-and-documentation/).
+2. Ensure it meets our [technical](/docs/extensions/best-practices-extensions/extension-development-best-practices/), [user experience](/docs/extensions/ux-guidelines-extensions/best-practices/) (UX), and [security standards](https://developer.wordpress.org/apis/security/).
+3. Write clear and comprehensive [documentation](/docs/extensions/best-practices-extensions/support-and-documentation/).
### Step 2: Apply to the Marketplace
@@ -54,16 +54,16 @@ Submit detailed product information, demo links, and test instructions for revie
## Helpful resources
-- [Submission guidelines](https://woocommerce.com/document/submitting-your-product-to-the-woo-marketplace/)
-- [Extension developer handbook](https://developer.woocommerce.com/docs/extensions/getting-started-extensions/)
-- [Block theme developer handbook](https://developer.woocommerce.com/docs/theming/block-theme-development/theming-woo-blocks)
-- [SaaS Billing API](https://woocommerce.com/document/billing-api-for-saas-products/)
+- [Submission guidelines](/docs/woo-marketplace/submitting-your-product/)
+- [Extension developer handbook](/docs/extensions/getting-started-extensions/)
+- [Block theme developer handbook](/docs/theming/block-theme-development/theming-woo-blocks)
+- [SaaS Billing API](/docs/woo-marketplace/billing-api-saas/)
- [Marketplace Vendor Agreement](https://woocommerce.com/woo-vendor-agreement/)
## Ready to apply?
1. [Become a Marketplace partner](https://woocommerce.com/partners/).
-2. Before you submit, we recommend reviewing the full [submission guidelines](https://woocommerce.com/document/submitting-your-product-to-the-woo-marketplace/#section-1) for detailed steps.
-3. When you're ready, [submit your product](https://woocommerce.com/document/submitting-your-product-to-the-woo-marketplace/).
+2. Before you submit, we recommend reviewing the full [submission guidelines](/docs/woo-marketplace/submitting-your-product/#pre-submission-checklist) for detailed steps.
+3. When you're ready, [submit your product](/docs/woo-marketplace/submitting-your-product/).
We look forward to helping you succeed in the WooCommerce Marketplace!
diff --git a/docs/woo-marketplace/managing-products.md b/docs/woo-marketplace/managing-products.md
index c9f9001b257..26a1ef02a79 100644
--- a/docs/woo-marketplace/managing-products.md
+++ b/docs/woo-marketplace/managing-products.md
@@ -14,7 +14,7 @@ Most of the work for managing products can be done via the [vendor dashboard](ht
- From your vendor dashboard, navigate to _Products > All Products_.
- Select the product you want to work on.
-From there, you can see information about usage, upload a new version, or edit the product page. [Review our product page guidelines](https://woocommerce.com/document/marketing-product-pages-writing/).
+From there, you can see information about usage, upload a new version, or edit the product page. [Review our product page guidelines](/docs/woo-marketplace/product-page-content-and-assets/).
@@ -22,11 +22,11 @@ From there, you can see information about usage, upload a new version, or edit t
To maintain a high-quality and competitive Marketplace, we encourage all vendors to regularly update their products. Consistent updates ensure compatibility with the latest versions of WooCommerce and WordPress, improve security and performance, and deliver ongoing value to customers.
-[Review our product update guidelines and best practices](https://woocommerce.com/document/product-update-guidelines/).
+[Review our product update guidelines and best practices](/docs/woo-marketplace/product-update-guidelines/).
### Adding or editing documentation
-To review, edit, or add documentation, navigate to _Documentation_ in your vendor dashboard. [Review our guidelines for creating effective documentation](https://woocommerce.com/document/writing-documentation/).
+To review, edit, or add documentation, navigate to _Documentation_ in your vendor dashboard. [Review our guidelines for creating effective documentation](/docs/extensions/best-practices-extensions/support-and-documentation).
diff --git a/docs/woo-marketplace/managing-your-account.mdx b/docs/woo-marketplace/managing-your-account.mdx
index a387ba5ae5b..cf1b8273c29 100644
--- a/docs/woo-marketplace/managing-your-account.mdx
+++ b/docs/woo-marketplace/managing-your-account.mdx
@@ -69,7 +69,7 @@ Need to know how to reach another vendor? Type the vendor name and hit Enter to
### Changelog validator
-Test your `changelog.txt` file to ensure that it meets [Woo Marketplace standards](https://woocommerce.com/document/create-a-plugin/#section-9) by copying the text of the file and pasting it into the text box. You can also use our ChatGPT [Changelog Formatter](https://chatgpt.com/g/g-9b3SlOWTF-woocommerce-com-changelog-formatter) to automatically revise your existing changelog to use in your extension.
+Test your `changelog.txt` file to ensure that it meets [Woo Marketplace standards](/docs/extensions/core-concepts/changelog-txt/) by copying the text of the file and pasting it into the text box. You can also use our ChatGPT [Changelog Formatter](https://chatgpt.com/g/g-9b3SlOWTF-woocommerce-com-changelog-formatter) to automatically revise your existing changelog to use in your extension.
## FAQs
@@ -80,18 +80,3 @@ Test your `changelog.txt` file to ensure that it meets [Woo Marketplace standard
- To request another admin, [contact us via the link in your dashboard](https://woocommerce.com/wp-admin/admin.php?page=wcpv-vendor-support) or email [partners@woocommerce.com](mailto:partners@woocommerce.com) using your current partner account email. Please first ensure that they have [created a WooCommerce.com account](https://woocommerce.com/sso?new=1&next=%2Fwoocommerce%2F) with [two-step authentication enabled](https://wordpress.com/support/security/two-step-authentication/).
</details>
-
-<details>
-<summary>Why does my QIT test result link show "Invalid URL" or say it has expired?</summary>
-
-- QIT test result links are temporary signed URLs. They expire after a short period of time. This is expected and not an error.
-- To get fresh results, re-run the test from your [Vendor Dashboard](https://woocommerce.com/wp-admin/). New links will be generated with the updated results.
-
-</details>
-
-<details>
-<summary>How do I resubmit after making changes?</summary>
-
-- When your submission is in **Changes required** status, you can upload a corrected zip file directly from your [Vendor Dashboard](https://woocommerce.com/wp-admin/) and resubmit.
-
-</details>
diff --git a/docs/woo-marketplace/submitting-your-product.mdx b/docs/woo-marketplace/submitting-your-product.mdx
index ab471cf0a2a..2650314c7f2 100644
--- a/docs/woo-marketplace/submitting-your-product.mdx
+++ b/docs/woo-marketplace/submitting-your-product.mdx
@@ -14,8 +14,8 @@ We look forward to reviewing your extension, theme, or integration for listing i
This includes an analysis of the product's business model and revenue share structure with Woo, as well as product rationale, competition, and developer/company history.
-- **Mutually beneficial partnership**: Products must share revenue with Woo, exclude spam links, affiliate links, or links to upsell products outside of the Woo Marketplace. See our [monetization expectations](./monetization-expectations.md).
-- **Trademark compliance**: Ensure that product names do not violate Woo's [trademark guidelines](https://woocommerce.com/trademark-guidelines/#sg-trademarks). Select a unique name that builds your brand and sets your product apart from others. [Review our product name guidelines](https://woocommerce.com/document/product-page-content-and-assets/#section-14).
+- **Mutually beneficial partnership**: Products must share revenue with Woo, exclude spam links, affiliate links, or links to upsell products outside of the Woo Marketplace. See our [monetization expectations](/docs/woo-marketplace/monetization-expectations/).
+- **Trademark compliance**: Ensure that product names do not violate Woo's [trademark guidelines](https://woocommerce.com/trademark-guidelines/#sg-trademarks). Select a unique name that builds your brand and sets your product apart from others. [Review our product name guidelines](/docs/woo-marketplace/product-page-content-and-assets/#naming-guidelines).
- **Competitive pricing**: Is the proposed price equal to or less than the price of the product sold in other environments? Select a suggested price that matches the price you sell elsewhere.
</details>
@@ -32,7 +32,7 @@ PHP 7.4 reached [End of Life](https://www.php.net/supported-versions.php) (EOL)
- Products must support the two latest **major releases** of both [WooCommerce](https://wordpress.org/plugins/woocommerce/) and [WordPress](https://wordpress.org/download/).
- Products must adhere to foundational guidelines outlined in our [developer hub](https://developer.woocommerce.com/).
-- If your pricing model is based on a standard, tiered monthly subscription, we require you to implement the [SaaS Billing API](https://woocommerce.com/document/billing-api-for-saas-products/). API keys and sandbox access are granted manually after products are submitted for Marketplace consideration.
+- If your pricing model is based on a standard, tiered monthly subscription, you will be required to implement the [SaaS Billing API](/docs/woo-marketplace/billing-api-saas/) before launch. API keys and sandbox access are granted manually after products are submitted for Marketplace consideration.
- Products must be able to pass the following [Quality Insights Toolkit](https://qit.woo.com/docs/) (QIT) tests:
- [API](https://qit.woo.com/docs/managed-tests/woo-api)
- [End-to-end](https://qit.woo.com/docs/managed-tests/woo-e2e) (E2E)
@@ -48,9 +48,9 @@ PHP 7.4 reached [End of Life](https://www.php.net/supported-versions.php) (EOL)
<summary>User experience compliance</summary>
- The product review includes a deeper analysis of the product's user experience (UX) and user interface (UI).
-- Ensure that your product's [critical flows](https://developer.woocommerce.com/testing-extensions-and-maintaining-quality-code/critical-flows/) have been thoroughly tested. See an example of [critical flows in the core WooCommerce plugin](https://developer.woocommerce.com/docs/contribution/testing/core-critical-flows/).
-- Extensions must adhere to [development best practices](https://developer.woocommerce.com/docs/extensions/best-practices-extensions/extension-development-best-practices/) and [UX guidelines](https://developer.woocommerce.com/docs/extensions/ux-guidelines-extensions/).
-- Themes must adhere to [theme development](https://developer.woocommerce.com/docs/theming/block-theme-development/theming-woo-blocks/), [design](https://developer.woocommerce.com/docs/user-experience-guidelines/ux-guidelines-themes/), and [UX guidelines](https://developer.woocommerce.com/docs/user-experience-guidelines/ux-guidelines-themes/).
+- Ensure that your product's [critical flows](https://developer.woocommerce.com/testing-extensions-and-maintaining-quality-code/critical-flows/) have been thoroughly tested. See an example of [critical flows in the core WooCommerce plugin](/docs/contribution/testing/core-critical-flows/).
+- Extensions must adhere to [development best practices](/docs/extensions/best-practices-extensions/extension-development-best-practices/) and [UX guidelines](/docs/extensions/ux-guidelines-extensions/).
+- Themes must adhere to [design](/docs/theming/theme-development/theme-design-ux-guidelines/), and [UX guidelines](/docs/user-experience-guidelines/ux-guidelines-themes/). If you are submitting a block theme, also review [theme development](/docs/theming/block-theme-development/theming-woo-blocks/).
- **Accessibility**: It is important that all customers can use the stores where your extension is installed. Extension submissions must meet the [WordPress Accessibility Coding Standards](https://developer.wordpress.org/coding-standards/wordpress-coding-standards/accessibility/). For more information, review WordPress's [accessibility quick start guide](https://make.wordpress.org/accessibility/handbook/best-practices/quick-start-guide/).
- Does the product have a single core purpose and use WooCommerce features as much as possible?
- Can the product function "out of the box" without much configuration?
@@ -97,7 +97,7 @@ As we evolve within the WordPress ecosystem, we're placing a strong emphasis on
High-Performance Order Storage (HPOS) is the **default experience for new WooCommerce stores**. It moves order data from the WordPress post and postmeta tables to dedicated order tables to improve scalability and reliability.
:::info
-**All new extension submissions must be HPOS-compatible.** View our [HPOS recipe book](https://developer.woocommerce.com/docs/hpos-extension-recipe-book/) for ways to support HPOS in your product.
+**All new extension submissions must be HPOS-compatible.** View our [HPOS recipe book](/docs/features/high-performance-order-storage/recipe-book/) for ways to support HPOS in your product.
:::
</details>
@@ -170,6 +170,14 @@ Yes. You are welcome to resubmit products, providing the previously-received fee
</details>
+<details>
+<summary>Why does my QIT test result link show "Invalid URL" or say it has expired?</summary>
+
+- QIT test result links are temporary signed URLs. They expire after a short period of time. This is expected and not an error.
+- To get fresh results, re-run the test from the submission in your [Vendor Dashboard](https://woocommerce.com/wp-admin/). New links will be generated with the updated results.
+
+</details>
+
## Submission support
For additional questions related to your submission, please use the discussion box below the **Submission Bot** results table in the **Submission progress** tab within your vendor dashboard.