User Experience (UX) reviews have been introduced into the Marketplace submission review process to ensure submitted products adhere to product quality, Marketplace standards and guidelines before launching in the Marketplace. With this additional review, you can anticipate longer review times however, here are best practices to zip through the UX review.
Pre-Submission
↑ Back to topBe proud of your product. In your submission, highlight product differentiators that exemplify why your product stands out from similar products currently listed in the Marketplace. If your product is simply a better product than direct competitors, don’t be afraid to state so, it’s after all the whole essence of open-source.
Provide a full testing environment complete with all necessary and relevant data, (e.g demo sites, demo login, demo accounts logins, walkthrough video URL, plugin URL, etc) so that the Marketplace team has the ability to fully test your product. For example, pre-actively providing login credentials to your demo website with the product fully configured and/or providing test demo accounts for 3rd party platforms that your product integrates with. Failure to provide all of the necessary testing resources will delay your submission.
Always include WooCommerce checks – the first item tested is whether your plugin breaks when WooCommerce is not installed / activated.
Test, Test and Test. Ensure the product works as expected before submitting. More often than not, critical errors or major bugs are found in submitted products during UX review. You can save time by testing all possible scenarios prior to submitting. Also, be sure to test the critical flows applicable to your product.
Review and proofread your in-product copy again and again. Ensure grammar and punctuation is on point and spellings/typos are non-existent. For example, capitalize the first letter of the first word in a sentence, include periods at end of sentences, and use commas when necessary. And the first “c” in WooCommerce is always capitalized. For more, read our Grammar, Punctuation, and Capitalization guide.
Guide the merchant during onboarding. The first experience your users have with your product is crucial. Is it clear to the user how to get started? Consider adding a dismissable admin notice with product onboarding instructions. For example, “[Plugin name] is ready to use. Get started here.” However, keep in mind that the more steps a product has, the more likely a user will abandon the product altogether so keep it well-balanced. For more onboarding best practices, refer to our UX guidelines.

Integrate with WooCommerce. The plugin should feel as if its naturally integrated into WooCommerce and not as an add-on plugin. Ask yourself the following:
- Is the plugin settings menu placed within the WooCommerce navigation menu?
- Does the plugin use the existing WordPress/WooCommerce UI, built in components (text fields, checkboxes, etc) and existing menu structures?
- Does the color scheme match WooCommerce?
- Does the plugin home screen simply state the feature of the plugin, e.g “Bookings” instead of “VendorXYZ Bookings Plugin for WooCommerce.”
Plugins which draw on WordPress’ core design aesthetic will benefit from future updates to this design as WordPress continues to evolve. If you need to make an exception for your product, be prepared to provide a valid use case. Here are resources to reference to make sure your product is aligned with the WordPress/WooCommerce design system:
- Marketplace User Experience Guidelines
- WordPress Components library
- Figma for WordPress
- WooCommerce Admin
Are you using external links at any point in-product? If so, don’t. This includes the Plugin Installer page – all links need to point to WooCommerce, e.g vendor page, plugin product page, support contact form, etc. This ensures a consistent user experience by keeping the user on WooCommerce.
Feature overload or feature creep is real and is to be considered when developing products for WooCommerce. After all, you don’t want to overwhelm the user with too many options that the product feels unusable to them. During the UX review, we will highly be paying attention to this factor. Do yourself (and us) a favor by keeping this in check and only including setting options / features that are crucial to the overall functionality of the product. Use smart defaults when possible, and remember, settings should be pre-configured and optional.
Offboarding don’ts. When users uninstall your plugin or theme, it is disruptive and intrusive to display any sort of screen capturing the reason for uninstallation. Do not collect user information (email address, URL site, etc) as this is prohibited per Marketplace Terms of Service.
Technical Documentation
Tend to your product technical documentation with a lot of care. Ideally, your product is configurable without the user having to reference the technical documentation but even so, having clear, informative, and precise technical documentation is key. This is not only critical for the user, but also for the WooCommerce Happiness team providing pre-sales support. Additionally, having full-fledged technical documentation alone can be empowering to a user helping to improve customer experience and reduce product churn. So, with this in mind, please take your time to document the step-by-step setup, configuration, usage and FAQ for the product as if a novice beginner will be using your product. Refer to our Technical Documentation guide for information and examples.
Proofread, Proofread, Proofread. Please, please check for styling inconsistencies, punctuation and grammatical errors, misspellings and typos, etc (because trust, we do notice them and there’s no need for these minor items to delay launch.
Incorporate product changes wherever needed. If product update changes were made to backend or frontend experiences, remember to update applicable screenshots and text in the technical documentation.
During UX review
↑ Back to topProduct feedback will be provided by the Marketplace team directly in the submission. Please keep in mind that every time a product is sent back to your team for fixes, your product is re-queued for review meaning it’s placed at the end of our regular queue and is not prioritized, further causing delays.
Incorporate product changes wherever needed. Please be sure that any product changes are reflected in the product documentation and technical documentation. For example, if setting options are removed from the admin backend, remember to make the necessary updates in the relevant product screenshots and documentation, if applicable.
Your product can be rejected at any point in the review process. Even after passing Code Review and Business Review, the product can be rejected and not approved for launch, this includes UX review.
All in all, we do our best to review products as swiftly as possible. You can help us out by taking the time to only submit your product once it’s all buttoned-up, polished and ready to shine.