WooCommerce 7.2 includes:

• WooCommerce Blocks Updates
• WooCommerce Core Updates

Blocks 8.8.0 Testing instructions

Blocks 8.8.1 Testing instructions

Blocks 8.8.2 Testing instructions

Blocks 8.9.0 Testing instructions

Blocks 8.9.1 Testing instructions

1. Install a plugin that lets you specify min/max product quantities
2. Create a simple product with min_qty=max_qty.
3. Go add the product page. You will be able to see the quantity input there.

1. Enable the new-product-management-experience feature flag by using the WCA Test Helper (Tools > WCA Test Helper > Features) and refresh the page.
2. Create some categories under Product > Categories
3. Click the Products > Add New (MVP) button and notice the new category field dropdown.
4. Start searching in the dropdown field and make sure your created categories show up
5. See if categories are correctly sorted by popularity first and then alphabetical order (popularity is by how many products its being used).
6. Select one of the child categories, it should auto select the parents but allow you to un-select the parents
7. You should also be able to use your keyboard by using your up and down arrows, currently I have the selected item highlighted by setting it to bold and have closed parents automatically open if they have children.

1. Start with a fresh site.
2. Access the business directly via http://your-site/wp-admin/admin.php?page=wc-admin&path=/setup-wizard&step=business-details
3. Confirm the page renders without any JS errors.

1. Go to the Add new product page
2. Click on Shipping class dropdown field
3. Select Add new shipping class option from the list
4. From New shipping class modal form, add a new shipping class name then click Add button.
5. When the modal closed the new shipping class added should be shown as the selected value of the Shipping class dropdown.

1. Locate a created product with attributes.
2. Visit /wp-admin/admin.php?page=wc-admin&path=/product/{productId} replace productId with your id
3. A close-small icon should be shown to remove the attribute instead the trash-can icon.

1. Make sure you have the new-product-management-experience feature flag enabled (you can do so using the latest version of the Beta tester within the mono repo).
2. Go to Products > Add new (MVP) and fill out some of the initial details like name and price
3. Move down to the attributes section and select Add first attribute a Modal should popup
4. A initial row should be added with an empty attribute and attribute term field, the attribute term field should be disabled and hitting the remove icon should not do anything.
5. Search for a category and select one, the attribute term field should be enabled now and you can search/select attribute terms (note that the attribute term field relies on the API for searching, it's not the smoothest at this point, but this will require separate updates to the SelectControl component, I do have a https://github.com/woocommerce/woocommerce/pull/34949 in flight for this, but it will require some updating).
6. You should be able to click Add another which will add another row, you should be able to delete any of them except for the last one. So if you click Add another you can remove the first row if you want.
7. Once you have added items you can click Add this should add it to the product list, any empty rows should be ignored, this includes rows with a selected attribute, but no terms selected.

1. Go to Add new product page or Edit product page
2. The action buttons should be shown in the header and not at the bottom of the form
3. You should see the action buttons only in those pages

1. Navigate to Products -> Add new (MVP)
2. Toggle off the "Track quantity for this product" setting
3. Switch between various stock statuses shown
4. Make sure that the stock statuses persist on refresh
5. Toggle on the "Track quantity for this product" setting
6. Make sure the stock statuses are not shown

Prerequisites You'll need to upload and activate the WooCommerce Payments plugin, to be able to add and remove payment methods in the user's account

1. Log in with a valid shop user
2. Go to My Account > Payment Methods
3. Add a Payment method
4. On Payment methods table, double click on 'Delete' button 5.Check that the payment method is correctly removed and there are no errors displayed to the user

This the behavior with the fix applied:

1. Navigate to the new product page Products -> Add new (MVP)
2. Check that styling for checkboxes is still correct
3. Add values to the price and dimension fields, using thousand commas and decimal separators (depending your locale)
4. Make sure they are sanitized on blur and persist correctly on save

1. Go to Add new product page
2. If you add a new shipping class you should see a placeholder: e.g. Fragile products in the name field of the Shipping Class dialog
3. Add a category to the product and then publish it.
4. When editing that product and try to add a new shipping class the first time in the shipping class name and slug fields of the Shipping Class dialog should be filled with the name and slug of the first product category.
5. If you added that new shipping class with the prefilled category data and try to add a new shipping class again then no prefilled name and slug should happend anymore per product edition.

6. If you try to add a new shipping class with any of the previous added slugs you should see a snackbar error with this message: We couldn’t add this shipping class. Try again in a few seconds.

1. Disable stock management at wp-admin/admin.php?page=wc-settings&tab=products&section=inventory
2. Navigate to Products -> Add new (MVP)
3. Check that the toggle to enable inventory management is disabled
4. Hover the toggle to see the tooltip
5. Enable site-wide stock management again
6. Make sure the toggle once again works
7. Check that hovering the toggle does not display the tooltip

1. Go to Add new product page
2. Fields List price, Sale price and SKU should not have placeholder.

1. Verify state list is available on Checkout page after selecting Senegal as shipping destination Country.

1. Go the Add new product page
2. The only field with (required) hint on the right side of its label should be the Name and the (optional) hit should not be shown for any field
3. This also apply to the New shipping class dialog form

1. Go to Add new product page
2. Product section title should says Product details

1. Go to Add new product page
2. Click the ? icon on the right side of the checkbox Feature this product
3. The tooltip message should has font-size: 13px and padding: 16px

1. Go to Add new product page
2. In Shipping class section, the space between dimensions and the image should be 40px

1. Go to Add new product page
2. The Shipping class dropdown should show the selected option correctly displayed with no visible glitches in all browsers.

1. Make sure you have the new-product-management-experience feature flag enabled (you can do so using the latest version of the Beta tester within the mono repo).
2. Go to Products > Add new (MVP) and scroll down to the attributes section
3. Click Add first attribute and make sure the select control dropdown still shows correctly.

1. Go to Products > Add New and notice how the long description is wrapped in a panel named Product Description
2. Do the same check for editing an existing product
3. Now download the Classic Editor plugin and edit an existing post or page and make sure they still look the same.

We should check if the banner still shows, it would look like this:

1. Make sure your store is in the USA and the currency is USD, if you click the Personalize your store task you can add sample products (which will include shippable products)
2. Create an order with a shippable product (ex: Hoodie)
3. The banner should show up if you are on the edit order page and these criteria are met:

• Jetpack is up to date and you are connected (this includes the user being connected)
• None of the UPS, Fedex, ShippingEasy, or ShipStation shipping plugins are installed
• Your store is in the USA and the currency is USD
• WooCommerce Shipping is not installed or it is installed but the Terms of Service hasn't been accepted (probably easier to just not have it installed)

1. Go to the new product management experience Products -> Add new (MVP)
2. And add some content to the description field (note there are still some odd quirks around block selection in the editor that are unrelated to this PR)
3. Save the content
4. Refresh and make sure it works as expected
5. Visit the old product edit page for the same product
6. Note that content works as expected

1. Enable/disable the stock management for products at wp-admin/admin.php?page=wc-settings&tab=products&section=inventory
2. Under the product page (Products -> Add new (MVP)), click "Advanced" in the inventory section
3. Note that when stock management is enabled, the "out of stock" options exist
4. Note that in both cases, the limit 1 per purchase checkbox exists

1. Navigate to the new product experience at Products-> Add new (MVP)
2. Note that the description editor has the toolbar buttons initially shown
3. Check that the toolbar is 40px in height
4. Note that the placeholder text is initially shown (Describe this product...)
5. Type / and insert an image or video block
6. Note that you an insert images via the media library
7. Insert a couple of blocks and hover between blocks to see that the block inserter ( sign and blue line) is shown between blocks

1. Make sure you have the new-product-management-experience feature flag enabled (you can do so using the latest version of the Beta tester within the mono repo).
2. Go to Products > Add new (MVP) and fill out some of the initial details like name and price
3. Scroll down and click Add first attribute in the attributes section
4. Select one of the attributes
5. Search for a attribute term that doesn't exist yet
6. The 'Create "your new attribute term name"' should show as an option
7. Click that and another modal should show with the create fields.
8. Fill out all the fields and click Add this should create the attribute term and add it as a selected item within the terms field
9. With localStorage.setItem( 'debug', 'wc-admin:*' ); run prior, it should show that a product_attribute_term_add and product_attribute_term_add_success event has been fired.
10. Open the modal again and select cancel this shouldn't do anything.
11. A user should not be able to click add when the name is removed.

** The WooCommerce Beta Tester plugin hasn't declared compatibility with HPOS, so use it to install the beta, RC or final release and then deactivate the plugin. You should then be able to proceed with the steps below. **

First, in case handy, here is a quick reminder on how to enable HPOS, etc 💡

• If necessary, start by running the WooCommerce ▸ Status ▸ Tools ▸ Create Custom Order Tables tool.
• Then, visit WooCommerce ▸ Settings ▸ Advanced ▸ Features and enable High-Performance Order Storage.
• Next, head on over to WooCommerce ▸ Settings ▸ Advanced ▸ Custom Data Stores and:
  • Select Use the WordPress posts table.
  • Select Keep the posts table and the orders tables synchronized.

1. Start by adding the following snippet to a suitable location, such as a wp-content/mu-plugin file (the goal of this snippet is to simulate how a 3PD might add a custom bulk action for orders):

$add_custom_bulk_action = function ( array $bulk_actions ) {
	return array_merge( $bulk_actions, [ 'custom-bulk-action' => 'Perform Custom Action!' ] );
};

$custom_bulk_action_handler = function ( string $redirect_to, string $action, array $ids ) {
	return $action === 'custom-bulk-action'
		? add_query_arg( 'bulk_action', 'custom-bulk-action-notice', $redirect_to )
		: $redirect_to;
};

$custom_bulk_action_notice = function () {
	if ( isset( $_GET['bulk_action'] ) && 'custom-bulk-action-notice' === $_GET['bulk_action'] ) {
		print '<div class="updated" style="border-left-color: #d7f"><p>Custom Bulk Action Handler Fired</p></div>';
	}
};

add_filter( 'bulk_actions-woocommerce_page_wc-orders', $add_custom_bulk_action );
add_filter( 'handle_bulk_actions-woocommerce_page_wc-orders', $custom_bulk_action_handler, 10, 3 );
add_action( 'admin_notices', $custom_bulk_action_notice );

2. With HPOS enabled (and WooCommerce Orders Tables set as the authoritative data store for orders), visit the order list screen. You should see a new bulk action ("Perform Custom Action!"):

3. Check the boxes for one or more order rows, select the above bulk action, and click on the "Apply" button. Once the page finishes reloading, you should see an admin notice like the following one:

1. Install Code Snippets and woocommerce-beta-tester
2. Create a new snipeet with the following code

function pre_install_plugins( $value ) {
    return array( 'invalid-plugin-slug' );
}

add_filter( 'woocommerce_admin_plugins_pre_install', 'pre_install_plugins', 999 );

3. Go to WooCommerce > Home
4. Go to marketing task
5. Click "Activate" button on Google Listings & Ads
6. Visit the WooCommerce->Status->Logs page wp-admin/admin.php?page=wc-status&tab=logs in a new tab
7. Select a tracks-* log from the dropdown
8. Search the wcadmin_install_plugin_error string
9. Observe that all event props are in snake_case like below:

2022-10-31T08:38:13 00:00 DEBUG wcadmin_install_plugin_error
2022-10-31T08:38:13 00:00 DEBUG   - error_message: The requested plugin `invalid-plugin-slug` could not be installed. Plugin API call failed.
2022-10-31T08:38:13 00:00 DEBUG   - api: Plugin not found.
2022-10-31T08:38:13 00:00 DEBUG   - slug: invalid-plugin-slug

10. Update the snippets with the following code

function plugins_api_result( $res, $action, $args ) {
	$res->download_link = 'invalid link';
    return $res;
}

add_filter( 'plugins_api_result', 'plugins_api_result', 999, 3 );

11. Repeat 4~9 steps
12. Observe that all event props are in snake_case like below:

2022-10-31T08:44:41 00:00 DEBUG wcadmin_install_plugin_error
2022-10-31T08:44:41 00:00 DEBUG   - error_message: The requested plugin `google-listings-and-ads` could not be installed.
2022-10-31T08:44:41 00:00 DEBUG   - slug: google-listings-and-ads
2022-10-31T08:44:41 00:00 DEBUG   - api_version: 2.2.0
2022-10-31T08:44:41 00:00 DEBUG   - api_download_link: invalid link
2022-10-31T08:44:41 00:00 DEBUG   - upgrader_skin_message: Downloading installation package from invalid link…,Download failed. A valid URL was not provided.
2022-10-31T08:44:41 00:00 DEBUG   - result: 

1. Go to Products > Add New.
2. Add a product name and a description.
3. In the Product data section select Variable product.
4. Go to Attributes and create (or select) a product attribute to use for variations.
5. Go to Variations and add a few variations (don't modify them).
6. Press Save changes.
7. Verify that a warning is shown with the number of variations without price.

8. Press Add price. A modal like the one below will be visible.

9. Verify the currency matches the currency used on the site.
10. Add a text (not numbers) and verify that the validation fails. Add a number with multiple decimal points and verify that the error text says: Please enter a value with one decimal point (%s) without thousand separators.
11. After adding a valid number the button OK should be enabled.
12. Add a valid number and press Add prices.
13. Verify that the Regular price for every variation is set with the number added in the modal.
14. Verify that the accordion expands after pressing Edit.
15. Press Save changes. The warning should disappear.
16. Publish the product.
17. Add another variation. Press Save changes. The warning should be shown again.
18. Now add another value and verify that the new value has been added to the new variation without modifying the other variations' values.

Now create a new product but select Variable subscription instead of Variable product in step 3, and continue with the other steps.

** The WooCommerce Beta Tester plugin hasn't declared compatibility with HPOS, so use it to install the beta, RC or final release and then deactivate the plugin. You should then be able to proceed with the steps below. **

First, in case handy, here is a quick reminder on how to enable HPOS, etc 💡

If necessary, start by running the WooCommerce ▸ Status ▸ Tools ▸ Create Custom Order Tables tool. Then, visit WooCommerce ▸ Settings ▸ Advanced ▸ Features and enable High-Performance Order Storage. Next, head on over to WooCommerce ▸ Settings ▸ Advanced ▸ Custom Data Stores and:

1. To test, you will first need to setup HPOS—making the custom order tables authoritative and enabling sync. You will also need a number of test orders to play with: if you don't have any existing order data, consider using a tool like WC Smooth Generator for that.
2. Next, visit WooCommerce ‣ Settings ‣ Advanced ‣ Custom Data Stores and change the data store to the WordPress Posts Table.
3. Try accessing the HPOS order admin list table at /wp-admin/admin.php?page=wc-orders: you should be redirected to the equivalent order post screen at wp-admin/edit.php?post_type=shop_order.
4. Repeat, but use a paged URL such as wp-admin/edit.php?post_type=shop_order&paged=3: you should be redirected to /wp-admin/edit.php?paged=3&post_type=shop_order (assuming you have at least 3 pages of order data).
5. Now try accessing the order editor via the HPOS new order screen at /wp-admin/admin.php?page=wc-orders&action=new: you should be redirected to /wp-admin/post-new.php?post_type=shop_order (simulates manually creating a new order).
6. Try acessing the order editor for an existing order, using a URL like https://wordpress.lab/wp-admin/admin.php?page=wc-orders&action=edit&id=123: you should be redirected to /wp-admin/post.php?action=edit&post=123 (of course, change 123 to the ID of an actual existing order within your test site).

Now a more advanced test.

1. Return to WooCommerce ‣ Settings ‣ Advanced ‣ Custom Data Stores and change the data store to the WooCommerce Orders Tables.
2. Visit the order admin list table at /wc-admin/admin.php?page=wc-orders and select one or more orders, then perform a bulk action such as changing the order status to Completed.

• You will also need to use your browser's developer tools for this test (if you are using Firefox, I recommend the Network tab with Persist Logs enabled), or some equivalent tool, to capture the initial URL that is created when you do this.
• Typically, it will take the form /wp-admin/admin.php?page=wc-orders&_wpnonce=ABCDEF&_wp_http_referer=/wp-admin/admin.php?page=wc-orders&action=mark_completed&order[]=1&order[]=2&action2=mark_completed (but you may also see some extra query parameters in there).

3. Go back to WooCommerce ‣ Settings ‣ Advanced ‣ Custom Data Stores and change the data store to the WordPress Posts Table.
4. Now try "re-playing" the URL you captured earlier, but change both instances of mark_completed to mark_processing. An appropriate redirect should take place and the bulk action should be processed, in this case resulting in the two orders being set back to "Processing".

1. Visit WooCommerce ‣ Settings ‣ General.
2. The symbol for Libyan Dinars (in the currency selector) should render as د.ل (previously, it was reversed).
3. If you select this currency and look at the storefront, you should see the same thing there.

1. Ensure you have at least 2 attributes with options configured.
2. Enable new products MVP feature flag
3. Go to new products MVP screen
4. Click the "add attribute button" at the bottom to open the add modal.
5. Add one of the attributes, as well as 1 or two of the associated options.
6. Click "Add" button, and ensure the attribute shows up in the attribute table.
7. Click "Edit" button on added attribute to open the edit modal.
8. Add another option to the attribute and click "update."
9. Ensure the UI on the attribute section has updated with that attribute.
10. Publish the product, but don't navigate away
11. Refresh the page, which should just load the same product.
12. Scroll to the bottom and ensure the updated options were persisted.
13. Add another attribute with the add modal, but don't publish the product.
14. Click "edit" on one of the attributes to open the edit modal.
15. Delete the name of the attribute in the top "attribute" field, and select the other from the drop-down.
16. It should switch the attribute field and auto populate the terms in the lower drop-down associated with this attribute.
17. Similarly, test delete attributes and checking both checkboxes, publish the product, and ensure the changes were persisted.

1. On a new site, do not complete the onboarding profiler and do not check the checkbox for "Setup for client" during onboarding
2. Install a plugin like WP Crontrol
3. Under Tools -> Cron Events, run wc_admin_daily
4. Make sure the note with a title of "Edit your store details if you need to" has not been added

1. Visit the new experience (Products-> Add new (MVP))
2. Add some content to the summary field
3. Publish the product
4. Make sure the data persists on refresh

1. Go to Products > Add New or edit an existing product
2. Scroll down and check if the Product short description is expanded by default.

1. Install a plugin like WP Crontrol
2. Under Tools -> Cron Events, run wc_admin_daily
3. Make sure the note with a title of "New! Manage your store activity from the Home screen" has not been added

1. Create at least 1 downloadable product
2. Install a plugin like WP Crontrol
3. Under Tools -> Cron Events, run wc_admin_daily
4. Make sure the note with a title of "Learn more about digital/downloadable products" has not been added

1. Go to WC > Status.
2. Scroll down to "Settings".
3. Confirm that there is a new row "Order datastore" with the classname for the current order datastore.
4. If HPOS is enabled, there should be another row "HPOS data sync enabled" indicating whether data sync has been enabled or not.
5. Repeat the above with different configurations of HPOS and data sync (enabled/disabled).

Test My subscriptions

1. Open WooCommerce > Extensions
2. Open the My Subscriptions tab
3. Connect to WooCommerce.com
4. Update your list of subscriptions
5. Confirm that your subscriptions are loaded
6. Confirm that other Helper functions that use the WC_Helper_API::get() and url() methods still works normally, e.g. visit the Plugins page and ensure you can activate, deactivate, and view the View Details modal for plugins hosted on WooCommerce.com

1. Install the WC-Admin Test Helper and enable the new-product-management-experience.
2. Go to Products > Add New (MVP).
3. Go to the Pricing section.
4. Verify that:

• When the toggle is enabled, we show the “From” and “To” date fields.
• By default, once the user flips the toggle, we fill the From field with the current date.
• Clicking the field opens a popover window with a calendar.
• When clicked, the user can enter the date using the keyboard. The user can enter dates using most common formats.
• Dates for the "From" and "To" fields are formatted using the site settings in Settings > General > Date Format.
• The popover uses the date picker component from Gutenberg (sidebar > Status & Visibility > Publish > Immediately).
• If the user selects a date from the calendar, we populate the date field in the popover and the actual From/To field.
• Users can clear the date by removing the contents of the From/To input field.

1. Go to Products > Add new (MVP)
2. Add a few images to the image gallery
3. Verify that the toolbar appears properly, along with the tooltips

1. Enable WooCommerce and WooCommerce Blocks.
2. Enable a block theme, and make sure you have some products with ratings.
3. Add the All Products block in the Site Editor.
4. Confirm that the 'Rating Star' icon is loading and the same goes for the '1 in cart' icon.

1. Navigate to the new product management experience ( Products -> Add new (MVP) ).
2. Note that "New product" exists in the header initially
3. Type something in the product name field
4. Note that the header is updated to reflect this name
5. Delete the content from the product name field
6. Note that the header reverts to "New product"
7. Save the product as a draft or publish
8. Remove the content from the product name field
9. Note that the previously saved name shows in the header
10. Type some content in the product name field
11. Note that the header is updated to reflect those changes

1. Go to the Add New (MVP) product page
2. The gray background should cover the full screen

1. Navigate to the new product management experience ( Add new (MVP) )
2. Click the "more" (vertical ellipsis) button in the top right of the header
3. Note that each of the links closes the menu
4. Note that clicking "Use the classic editor" takes you to the classic editing experience
5. Navigate back to the new experience and publish a product
6. Click again on "Use the classic editor"
7. Note that you are taken to the classic editor for the respective published product

1. Navigate to the new product management experience ( Products -> Add new (MVP) )
2. Note that the initial badge in the header next to the title is "Unsaved"
3. Make some changes and click "Save draft"
4. Note that the badge is now "Draft"
5. Publish the product
6. Note that the badge is "In stock"
7. Manually set the product to "out of stock" in the inventory section and update
8. Note that the badge is "Out of stock"
9. Click "Track quantity for this product" and enter a positive quantity number and save
10. Note that the badge is "In stock"
11. Set the inventory quantity to 0 and save
12. Note that the badge is "Out of stock"

1. Navigate to WooCommerce ▸ Settings ▸ General and update the currency settings so you are using the Azerbaijani Manat. Save.
2. Visit the storefront and ensure prices are displayed using the Manat ₼ symbol.

Checkout validation should continue to work as it did previously. More specifically, we should ensure that we are still validating if the custom has agreed to the shop's terms and conditions (since the change touches that check):

1. Ensure you have designated a terms and conditions page (via WooCommerce ▸ Settings ▸ Advanced ▸ Page Setup): terms-and-conditions

2. As a customer, add a product to your cart and attempt to checkout. In the first instance, populate the checkout form correctly but avoid checking the box that indicates you agree with the terms and conditions:

3. Consequently, on trying to checkout, you should see a warning as follows:

4. Rinse and repeat; except agree to the terms and conditions. If all other fields are correctly populated, you should be able to checkout successfully.
5. Repeat again, but try to supply invalid values to other checkout fields (for example, you might provide an invalid postal code) and confirm validation successfully prevents this.

On a new install,

1. Click "Add Products" from the task list.
2. See that the new stacked layout screen is shown (compare to screenshot above).
3. Check the accordion functionality works by clicking "View more product types".
4. Click the "Physical product" list item.
5. See that the "New Product " screen is shown and is pre-filled to a "simple product" type.

1. Visit the Add new product page
2. When hover the ? icon next to Add media button a tooltip should show like below:

3. When hover the ? icon next to panel with title Product short description a tooltip should show like below:

4. Every time the page is visited or refreshed the Product short description panel should remain collapsed by default.

1. Install WCPay and use the Date filter on the Transactions or Disputes pages.
2. Select a date.
3. Click again on the date picker. Verify there is no error, and that date selection works properly.
4. Activate the filter and verify that the selected dates for the filter are applied properly.

1. Go to any Analytics page.
2. Click on the "Date range" and click "Custom".
3. Verify that the calendar styling is fixed.

1. Make sure you have the new-product-management-experience feature flag enabled (you can do so using the latest version of the Beta tester within the mono repo).
2. Create a couple products
3. Go to Analytics > Products
4. Select Comparison from the Show dropdown
5. Select a couple products and click Compare
6. A notice should show up that allows you to share feedback, click this.
7. Make sure the emoji's show up correctly in a horizontal format.
8. Note: that this notice will probably only show up once, once you click Share feedback, in order for it to show again you can delete the woocommerce_ces_shown_for_actions option.

1. Add https://github.com/woocommerce/woocommerce-min-max-quantities.
2. Create a simple product with min_qty=max_qty.
3. Go add the product page. You will be able to see the quantity input there.
4. As a customer, visit the product page. You should be able to purchase the product and the price in the cart should match your expectations.
5. Now edit the composite product and set the min and max values to the same value. Save.
6. Repeat the process ... of course, you can still specify the type of memory (128KB or 512KB) but can longer specify how much you want. Add to the cart, pricing again should match your expectations (based on the unit cost and the predetermined quantity, etc).