Release Testing Instructions WooCommerce 6.8

WooCommerce 6.8 includes:

• WooCommerce Blocks Updates
• WooCommerce Core Updates

WooCommerce Blocks Updates:

Blocks Release 8.0.0: (download)

Enhancements:

Make form components require onChange and have a default value. (https://github.com/woocommerce/woocommerce-blocks/pull/6636)

1. Create a new page with All Products block, Filter Products By Price Block and Filter Products By Attribute Block.
2. Go to the All Products page, ensure you're able to sort products and filter products by price and attribute.
3. Add a product to the cart.
4. Go to the Checkout block page.
5. Ensure you're able to use radio controls.

Footer Template Parts use now <footer> instead of <div> and Header uses <header> instead of <div>. (https://github.com/woocommerce/woocommerce-blocks/pull/6596)

1. Go to a Woo page and view the source.
2. Check the header is wrapped in a <header> tag, not in a <div>.
3. Check the footer is wrapped in a <footer> tag, not in <div>.

Before:

After:

Replace the ProductTag tax_query field to be the term_id instead of the id. (https://github.com/woocommerce/woocommerce-blocks/pull/6585)

1. Create a page and add a Products by Tag block.
2. Check that is rendered correctly in the editor.
3. Save the page and check that is rendered correctly in the frontend.

Bug Fixes:

Fix: Correctly calculate taxes for local pickups. (https://github.com/woocommerce/woocommerce-blocks/pull/6631)

1. Set store address to 123 Test Street, 90210 Beverly Hills, CA, USA
2. Enable taxes
3. Add a "Standard" tax rates in US, CA. Set it to: 10%
4. Add the following shipping methods: "Flat rate" for $10 and "Local pickup" for free.
5. Add a payment option (e.g., Cash on delivery).
6. Add a physical product to the cart.
7. Use an outside state address on the front-end. (e.g., 60 29th Street #343, 35005 birmingham, AL, USA)
8. Go to the Cart block and select the Local pickup shipping method. Check that we have a tax of 10% applied.
9. Go to the Checkout block and select the Local pickup shipping method. Check that we have a tax of 10% applied.
10. Place your order. Check on the Order received page that the displayed tax is actually added to the total.
11. Go to Edit Order. Check that taxes were applied correctly there as well.
12. On Checkout again, select flat rate, using the same external address, and make sure taxes are not applied.

Fix: Ensure WooCommerce templates show correct titles. (https://github.com/woocommerce/woocommerce-blocks/pull/6452)

Before	After

1. Go to Appearance → Editor → Browse all templates
2. Make sure you have archive-product.html in your theme's templates directory
3. Notice the archive-product.html template shows the correct title and description.

Blocks Release 7.9.0: (download)

Disable page scroll when Mini Cart drawer is open. (https://github.com/woocommerce/woocommerce-blocks/pull/6532)

1. Add the Mini Cart block to a post, page, or in the Site Editor.
2. In the frontend, click on the Mini Cart button so the drawer opens.
3. Try scrolling the page and verify you can't.
4. Close the drawer and verify you can scroll again.

Fix images hidden by default in Product grid blocks. (https://github.com/woocommerce/woocommerce-blocks/pull/6599)

1. With WC core 6.5.1 and WC Blocks disabled, add a Handpicked Products block to a post or page.
2. Hide the Product price and Product rating using the sidebar toggles.
3. Publish the post or page.
4. Update to WC core to 6.8.0.
5. Verify images are visible by default.
6. Verify you can still toggle the images.

Fix: Scrolling issue of the Filled Mini Cart Contents block. (https://github.com/woocommerce/woocommerce-blocks/pull/6565)

1. With a block theme like 2022. Edit the Mini Cart template part.
2. Add some blocks to the Mini Cart Items section to make the content overflow.
3. See the footer inside the viewport, and the Mini Cart Items block is now scrollable to view the underneath content.
4. Save the template.
5. On the front end, add a product to the cart then open the Mini Cart.
6. See the Mini Cart Items section is scrollable, with the product table on top.

Added descriptions to the FSE WooCommerce Templates in the Editor UI. (https://github.com/woocommerce/woocommerce-blocks/pull/6345)

Testing template descriptions**

1. Activate a block theme, like Twenty Twenty Two
2. Open the Appearance > Editor (Beta)
3. Using the dropdown arrow next to the Template name, select the Browse all templates button
4. Confirm that all WooCommerce templates have descriptions
5. Open a template (like Mini cart)
6. make sure you can edit and save the content.

Testing the search template**

1. Activate a block theme, like Twenty Twenty Two
2. Make sure there's at least 1 product added
3. Run a product search: ?s={keyword}&post_type=product and make sure the products are being displayed correctly in a grid (using the search template, instead of the default one).

WooCommerce Core Updates:

add: partial spotlight for shipping smart defaults tour #33801

1. Start with a fresh install, install WCA Test Helper plugin and enable the shipping-smart-defaults and shipping-setting-tour feature flags
2. Start OBW and choose United States as store country
3. Choose "Physical products"
4. Complete the OBW without installing anything from the Business Details tab.
5. Navigate to WooCommerce -> Settings -> Shipping
6. "United States (US)" zone should be created with Free shipping method
7. There should be a partial tour kit spotlight over the two leftmost columns for step 1 of the tour, and over the rightmost column for step 2 of the tour.
8. Check that proceeding through the tour works as expected, and the spotlight should stick to the cells even through resizing or scrolling the window.

Fix additional payment task name #33727

1. Onboard to WooCommerce from a WCPay eligible country (select United States during setup for the location of your store)
2. Install WCPay during the OBW
3. Set up WCPay
4. Go to WooCommerce Home
5. Observe that Set up additional payment options task is displayed.

Fix missing manage button for TikTok #33731

1. Set woocommerce_show_marketplace_suggestions option to false
2. Go to the home screen and select the "Set up Marketing tools" task
3. Install TikTok
4. Visit the task again and confirm that the "Manage" button exists
5. Click the "Manage" button
6. Should be redirected to the TikTok manage page

Fix wrong copy in the payment task #33749

Non-WCPay Country:

1. Choose a country that WCPay is not supported (try Mexico)
2. Go to Woocommerce > Home
3. Go to the payment task
4. Observe that the section is displayed with the title Choose a payment provider and the description To start accepting online payments.
5. Observe that "see more" link is displayed

WCPay Country, WCPay not set up

1. Choose a country that WCPay is supported (United States)
2. Go to Woocommerce > Home
3. Go to the payment task
4. Click "Other payment providers"
5. Observe that the section is displayed with the title Other payment providers and the description Try one of the alternative payment providers.
6. Observe that "see more" link is displayed

WCPay Country, WCPay set up

1. Choose a country that WCPay is supported (United States)
2. Install and set up WCPay
3. Go to Woocommerce > Home
4. Go to the payment task
5. Observe that the section is displayed with the title Additional payment options and the description Give your customers additional choices in ways to pay..
6. Observe that "see more" link is displayed

Deploy header task variant from task list experiment #33750

1. Use a fresh site
2. Skip the onboarding wizard and select not allow to be tracked
3. Go to WooCommerce > Home
4. Observe that the header task variant (a header progress area and ordered list) is displayed.

Fix product variation tooltip #33741

1. Go to Products > Attributes and add some attributes with terms
2. Go to Products > Add New and change the product to Variable product
3. Go to the Attributes tab and add the attribute you created in step 2, make sure to select Used for variations and click Save attributes after (you have to add values here)
4. Go to the Variations tab and click Go for the Add variation selection.
5. It should now show a Default Form Values with a tooltip after (as shown in the screenshot), the tooltip should work as expected
6. The tooltip should say: Choose a default form value if you want a certain variation already selected when a user visits the product page

Add payment icons right next to the Discover other payments link #33744

WCPay is not installed and setup

1. Start with a fresh install.
2. Complete Onboarding Wizard with a WC Pay eligible country. (try United States)
3. Navigate to WooCommere -> Settings -> Payments
4. You should see Stripe and Paypal icons when country is the US

WC Pay is setup

1. Start with a fresh install
2. Complete Onboarding Wizard with a WC Pay eligible country. (try United States)
3. Set up WCPay.
4. Navigate to WooCommere -> Settings -> Payments
5. You should see Klarna, Paypal, Afterpay, Amazon Pay, and Affirm icons when country is the US

Update wcpay suggestion UI in payment task #33717

1. Onboard to WooCommerce from a WCPay eligible country BUT during onboarding opt out from installing WCPay
2. Go to Woocmmerce > Home
3. Go to payment task
4. Observe that the UI matches the design

Make store location and rates steps clickable #33661

1. Start with a fresh install.
2. Skip Onboarding Wizard
3. Install WCA Test Helper plugin and enable shipping-smart-defaults feature
4. Navigate to WooCommerce -> Home and click the shipping task.
5. Complete the store details and click continue
6. Complete the shipping rates and click continue
7. Try to revisit the store details and shipping rates by clicking them.

Add: Intro tooltips for shipping smart defaults #33688

Case 1: The store sells physical products and is located in the US, but Jetpack and WooCommerce Shipping are not installed.

1. Start with a fresh install and enable the shipping-smart-defaults and shipping-setting-tour feature flags
2. Start OBW and choose United States as store country
3. Choose "Physical products"
4. Complete the OBW without installing anything from the Business Details tab.
5. Navigate to WooCommerce -> Settings -> Shipping
6. "United States (US)" zone should be created with Free shipping method
7. There should be 3 steps in the tour, covering shipping zones, shipping methods and recommended shipping options
8. The tour should not appear again upon revisit or refresh of the page, if you complete the tour

Case 2: The store sells physical products, has Jetpack and WooCommerce Shipping installed and connected, and is located in the US.

1. Start with a fresh install and enable the shipping-smart-defaults and shipping-setting-tour feature flags
2. Start OBW and choose United States as store country
3. Choose "Physical products"
4. Install Jetpack and WooCommerce Shipping from the Business Details tab.
5. Complete the OBW
6. Connect and approve Jetpack when prompted.
7. Navigate to WooCommerce -> Settings -> Shipping
8. "United States (US)" zone should be created with Free shipping method
9. There should be 3 steps in the tour, with the third one highlighting the WooCommerce Shipping section
10. The tour should not appear again upon revisit or refresh of the page, if you complete the tour

Case 3: The store sells physical products, and is not located in US/Canada/Australia/UK (irrelevant if JP is installed or not).

1. Start with a fresh install and enable the shipping-smart-defaults and shipping-setting-tour feature flags
2. Start OBW and choose a country that is not one of the US, Canada, Australia, and UK
3. Choose "Physical products"
4. Complete the OBW without installing anything from the Business Details tab.
5. Navigate to WooCommerce -> Settings -> Shipping
6. "Country-you-chose" zone should be created with Free shipping method
7. There should be 2 steps in the tour, covering shipping zones and shipping methods
8. The tour should not appear again upon revisit or refresh of the page, if you complete the tour

Case 4: The store sells digital products

1. Start with a fresh install and enable the shipping-smart-defaults and shipping-setting-tour feature flags
2. Start OBW and choose any country
3. Choose "Downloads"
4. Complete the OBW without installing anything from the Business Details tab.
5. Navigate to WooCommerce -> Settings -> Shipping
6. You should not see any automatically created shipping settings and there should not be a tour

Fix untranslated texts on payment setting page #33718

On WC > Settings > Payments, make sure that this text is not untranslated when English is not the selected language:

Update store details task action url #33671

1. Go to WoomCommerce > Home
2. Click "store details"
3. Observe that you're redirected to the setting page.
4. Fill out "Address line 1" and "city"
5. Go to WooCommerce > Home
6. Observe that "store details" is mark as completed.

Fix wrong link and copy in payment setting page #33716

1. Onboard to WooCommerce from a WCPay eligible country (opt in to install WCPay during the initial onboarding)
2. Go to Payments Settings
3. The call to action for WCPay inside the table should say Finish set up
4. The link at the bottom of the Payment Methods table should say Discover other payment providers
5. The Discover other payment providers link should direct the user to the external marketplace (https://woocommerce.com/product-category/woocommerce-extensions/payment-gateways/)

Fix wrong link in setup payments screen #33715

1. Onboard to WooCommerce from a country that WCPayments doesn't support
2. Go to WooCommerce Home
3. Click on the Set up payments task
4. Click "See more"
5. Should redirect to https://woocommerce.com/product-category/woocommerce-extensions/payment-gateways/?utm_source=payments_recommendations

Making product image meta box more prominent as a default #33707

1. Check out on fresh site (no preexisting DB entries).
2. Skip Onboarding Wizard.
3. Go to Product management page and add new product.
4. Confirm that the Product Image and Product gallery meta boxes are 2nd and 3rd in line on the right side.

Fix wrong copy in the payments settings for a country that WCPay is not supported #33665

1. Onboard to WooCommerce from a country that WCPayments doesn't support
2. Go to WooCommerce Settings > Payments
3. Scroll down to see the link at the bottom of the page
4. The table title should be: Recommended payment providers
5. The link copy should say: Discover other payment providers
6. The link should direct the user to the external marketplace: https://woocommerce.com/product-category/woocommerce-extensions/payment-gateways/

Fix wrong copy in the payments task on the Home Task list #33663

1. Go to OBW and choose a WCPay eligible country
2. Opt-in to install WCPay during the initial onboarding
3. Go to WooCommerce Home
4. Observe that the payment task displays:

Shipping recommendation task set location step manual navigation #33667

1. Enable the shipping-smart-defaults feature via WCA Test helper plugin.
2. Set up a store in US
3. Go to WooCommerce > Settings > Shipping
4. Wait for "Recommended shipping solutions" to appear and click on "Get started" or "Activate" on WooCommerce Shipping
5. When the task is loaded, click on "Set store location"
6. Observe the current step is now store location
7. Click on "Continue" button
8. Observe next step is displayed

Payment task: fix wrong copy in the accordion link #33662

1. Onboard to WooCommerce from a WCPay eligible country BUT during onboarding opt-out from installing WCPay
2. Go to WooCommerce Home
3. Click on the payments-related task on the task list
4. Observe that the accordion link should say Other payment providers

Update shipping logic when OBW is skipped #33630

Country is unknown

1. Start with a fresh install.
2. Install WCA Test Helper
3. Go to Tools -> WCA Test Helper -> Features and enable shipping-smart-defaults feature
4. Skip OBW.
5. Go to WooCommerce -> Home and confirm the shipping task is shown. Click on it.
6. Go through each step and confirm the updated design and text copy.
7. Click [Install & Enable] button in step 3.
8. You should see step 4 to connect your store to Jetpack

Country is either 'AU', 'CA' or 'GB'

1. Start with a fresh install.
2. Install WCA Test Helper
3. Go to Tools -> WCA Test Helper -> Features and enable shipping-smart-defaults feature
4. Start OBW with 'AU', 'CA', or 'GB' country and complete it without installing any additional plugins.
5. Go to WooCommerce -> Home and confirm the shipping task is shown. Click on it.
6. Go through each step and confirm the updated design and text copy.
7. Click [Install & Enable] button in step 3.
8. You should not see step 4 as you're already connected.

R

Add new flow shipping recommendation task #33620

1. Enable the shipping-smart-defaults feature via WCA Test helper.
2. Set up a store in US
3. Go to WooCommerce > Settings > Shipping
4. Wait for "Recommended shipping solutions" to appear and click on "Get started" or "Activate" on WooCommerce Shipping
5. Observe it gets redirected to step 2 of admin.php?page=wc-admin&task=shipping-recommendationtask
6. Click on "Install & enable" and observe woocommerce-services and jetpack plugins are installed
7. Click on "Connect" on the next step and connect site to WPCOM
8. When redirected back, observe the task automatically redirects to admin.php?page=wc-settings&tab=shipping&section=woocommerce-services-settings

Add logic to set the default shipping options on homescreen #33547

For each test case, please delete all the shipping zones and woocommerce_admin_created_default_shipping_zones option, or start with a fresh install.

Case 1: The store sells physical products and is located in the US, but JP and WCS are not installed.

1. Start with a fresh install
2. Start OBW and choose United States as store country
3. Choose "Physical products"
4. Complete the OBW without installing anything from the Business Details tab.
5. Navigate to WooCommerce -> Settings -> Shipping
6. "United States (US)" zone should be created with Free shipping method

Case 2: The store sells physical products, has JP and WCS installed and connected, and is located in the US.

1. Start with a fresh install
2. Start OBW and choose United States as store country
3. Choose "Physical products"
4. Install Jetpack and WooCommerce Shipping from the Business Details tab.
5. Complete the OBW
6. Connect and approve Jetpack when prompted.
7. Navigate to WooCommerce -> Settings -> Shipping
8. "United States (US)" zone should be created with Free shipping method

Case 3: The store sells physical products, and is not located in US/Canada/Australia/UK (irrelevant if JP is installed or not).

1. Start with a fresh install
2. Start OBW and choose a country that is not one of the US, Canada, Australia, and UK
3. Choose "Physical products"
4. Complete the OBW without installing anything from the Business Details tab.
5. Navigate to WooCommerce -> Settings -> Shipping
6. "Country-you-chose" zone should be created with Free shipping method

Fix shipping display logic United Kingdom country code #33629

1. Use a fresh site
2. Enable the shipping-smart-defaults feature via WCA Test helper.
3. Go to OBW
4. Set store location to the UK.
5. Go to Woocommerce > Home
6. Observe that the "Shipping" task is displayed.

Added local pickup handling in get_tax_location(). #33330

1. Set store base address to somewhere in OH, USA (eg: 123, Some street, OH, USA, 43001).
2. Update Tax Options (WooCommerce > Settings > Tax > Tax options) as below.
3. Set up a Tax Rate table for a single State, such as Ohio:
4. Add "Shipping Zone" for the USA and add "Local Pickup" shipping method to Shipping Zone (taxable)
5. Attempt to purchase any product with an address that doesn't match the location in the tax rate table (i.e. the table is for US > OH, so use an address like Austin, TX 78701)
6. Select the "Local Pickup" method and notice the order total amount shown at checkout (which includes taxes), and place the order with the "Direct bank transfer" payment method.
7. Go to wp-admin and open the edit order screen of the order we just placed, Press Recalculate, and make sure the tax is calculated properly.

Fixed missing wcpay setup task #33590

1. Setup store with wcpay installed, then finish steps 1 (onboarding wizard) and 2 (add a product) of task list.
2. Go to Wordpress home and click on Woocommerce setup widget which should be at step 3
3. Expect to proceed with woocommerce payments setup instead of blank screen

Fix: improve woocommerce-admin plugin deactivation notice message #33592

1. Install WooCommerce < 6.4, and WooCommerce Admin 3.3.2
2. Update WooCommerce to this version
3. Should see updated notice message

Update shipping task display logic #33533

Prerequisites

1. Use a fresh site
2. Enable the shipping-smart-defaults feature via WCA Test helper.

When a user skips OBW

1. Skip OBW
2. Go to Woocommerce > Home
3. Observe that the "Shipping" task is displayed. (Shipping task name may be different if you're assigned to a tasklist experiment treatment group. It should be Select how to ship your products, Set up shipping, or Add shipping costs. )

When store location is AU, CA or UK

1. Change store location to Australia.
2. Go to Woocommerce > Home
3. Observe that the "Shipping" task is displayed.

When store only sells digital products

1. Go to OBW > product types
2. Select "Downloads", and uncheck "Physical products"
3. Go to Woocommerce > Home
4. Observe that the "Shipping" task is not displayed.

Review shipping options Task

1. Update woocommerce_admin_created_default_shipping_zones option to yes.
2. Go to Woocommerce > Home
3. Observe that Review Shipping Options task is displayed.
4. Click the Review Shipping Options task
5. Observe that the page is redirected to Setting > Shipping
6. Update woocommerce_admin_reviewed_default_shipping_zones option to yes.
7. Go to Woocommerce > Home
8. Observe that Review Shipping Options task is completed

Update shipping recommendations display logic #33529

1. Use a fresh site
2. Enable the shipping-smart-defaults feature via WCA Test helper.
3. Go to OBW and set store country to a non-US country.
4. Go to Woocommerce > Settings > Shipping tab
5. Observe that "Woocommerce Shipping" is NOT displayed as a recommended extension
6. Change store country to the US.
7. Go back to Woocommerce > Settings > Shipping tab
8. Observe that "Woocommerce Shipping" is displayed as a recommended extension
9. Install and activate Woocommerce Shipping
10. Go back to Woocommerce > Settings > Shipping tab
11. Observe that "Woocommerce Shipping" is displayed and the CTA button is Activate.
12. Install and connect Jetpack.
13. Go back to Woocommerce > Settings > Shipping tab
14. Observe that "Woocommerce Shipping" is NOT displayed

Show generic error when trying to process a checkout while offline #30860

1. Add items to cart and proceed to checkout
2. Before clicking 'place order' turn your device offline. Unplug the network cable, turn off wifi or select the offline setting in the network tab of the chrome developer tools under throttle options.
3. You should see helpful error instead of blank red notice.

Add sort method to hide hidden columns #31866

1. Go to 'Products' in wp-admin
2. Click on 'Sorting' (next to 'All', 'Published', 'Trashed', etc.)
3. Open 'Screen Options' and disable 1 or more columns
4. Drag a product to change order
5. See that the table stays the same as without dragging

Fix broken design of Single Product template in block themes and on-sale badge being partially hidden #33511

1. Install and activate the Twenty Twenty-Two theme.
2. Navigate to the single product page of a product that is on sale.
3. Confirm the on-sale badge is fully visible and doesn't overlap with the breadcrumb navigation.
4. Create a new product and make sure it has no description, no reviews, and no additional information.
5. Visit that product on the Frontend.
6. Verify the footer doesn't render on top of the single product template.

Adjust DKK Currency Symbol #33509

1. Set currency in wp-admin / Woo Settings
2. Ensure store is set to Denmark, and set to use DKK as the currency.
3. Check Frontend Displaying in Product, Cart, Checkout. Should show kr as the short symbol

Fix unusable historical import

#34054

1. Go to Analytics -> Settings
2. Open browser inspector
3. Refresh
4. Observe request to /reports/import/totals