Improve public-facing text and labels

[sunyatasattva]

We noticed that oftentimes our labels and text tend to be overly technical or unclear. As the blocks experience becomes more and more common place, we should prioritize improving our text as essential to UX. Thanks to @ifinoi's amazing work, we have identified the problematic labels and came up with a replacement for each of them.

Original text	Replacement	References
Note: by choosing “Cover” you will lose the ability to freely move the focal point precisely.	This may affect your ability to freely move the focal point of the image.	assets/js/blocks/featured-category/block.js:225,assets/js/blocks/featured-product/block.js:326 build/featured-category.js:1,build/featured-category.js:6 build/featured-product.js:1
Choose “Cover” if you want the image to scale automatically to always fit its container.	Select "Cover' to have the image automatically fit its container.	assets/js/blocks/featured-category/block.js:219,assets/js/blocks/featured-product/block.js:320 build/featured-category.js:1,build/featured-category.js:6 build/featured-product.js:1
Mini Cart Empty Cart Message	Empty Mini Cart Message	src/BlockTypes/MiniCart.php:515
Edit the appearance of your empty and filled mini cart contents.	Edit the appearance of the Mini Cart.	build/mini-cart.js:1
Block that Shows the shopping button for the Mini Cart block.	Block that displays the shopping button when the Mini Cart is empty.	assets/js/blocks/mini-cart/mini-cart-contents/inner-blocks/mini-cart-shopping-button-block/block.json
Removal will cause unintended effects on your store.	Removing this will cause unintended effects on your store.	build/legacy-template.js:1
Attention: Do not remove this block!	Do not remove this block!	build/legacy-template.js:1
Contains blocks that are displayed when the mini cart has products.	Contains blocks that display the content of the Mini Cart.	assets/js/blocks/mini-cart/mini-cart-contents/inner-blocks/filled-mini-cart-contents-block/block.json
Filled Mini Cart Contents	Filled Mini Cart view	assets/js/blocks/mini-cart/mini-cart-contents/inner-blocks/filled-mini-cart-contents-block/block.json
Contains blocks that are displayed when the mini cart is empty.	Blocks that are displayed when the Mini Cart is empty.	assets/js/blocks/mini-cart/mini-cart-contents/inner-blocks/empty-mini-cart-contents-block/block.json
Empty Mini Cart Contents	Empty Mini Cart view.	assets/js/blocks/mini-cart/mini-cart-contents/inner-blocks/empty-mini-cart-contents-block/block.json
Something went wrong.	Something went wrong. Please contact us for assistance.	assets/js/base/context/providers/cart-checkout/checkout-processor.js:259,build/cart-frontend.js:4 build/cart.js:36 build/checkout-frontend.js:4,build/checkout.js:26
This is an editor placeholder for the %s. On your store this will be replaced by the template and display with your product image(s), title, price, etc. You can move this placeholder around and add further blocks around it to extend the template.	This is a placeholder for the %s. In your store it will display the actual product image, title, price, etc. You can move this placeholder around and add more blocks around it to customize the template.	build/legacy-template.js:3
Edit inner product layout	Edit the layout of each product	assets/js/blocks/products/all-products/edit.js:151 build/all-products.js:36
The selected attribute does not have any term assigned to products.	There are no products with the selected attributes.	assets/js/blocks/attribute-filter/block.js:525,build/attribute-filter-frontend.js:29 build/attribute-filter.js:33
Ensure customers agree to your terms and conditions and privacy policy.	Ensure that customers agree to your Terms & Conditions and Privacy Policy.	assets/js/blocks/checkout/inner-blocks/checkout-terms-block/block.json
You don't seem to have a Terms and Conditions and/or a Privacy Policy pages setup.	You don't have any Terms and Conditions and/or Privacy Policy pages set up.	build/checkout.js:34
Your store doesn't have any Payment Methods that support the Express Checkout Block. If they are added, they will be shown here.	Your store does not have any payment methods that support the Express Checkout block. Once you have configured a compatible payment method, it will be displayed here.	build/cart.js:40 build/checkout.js:42
Allow customers to filter the grid by products stock status. Works in combination with the All Products block.	Enable customers to filter the product grid by stock status.	assets/js/blocks/stock-filter/index.js:26 build/stock-filter.js:13
You currently have the following shipping integrations active.	The following shipping integrations are active on your store.	build/checkout.js:42
The WooCommerce Blocks feature plugin requires a more recent version of WooCommerce and has been paused. Please update WooCommerce to the latest version to continue enjoying WooCommerce Blocks.	The WooCommerce Blocks plugin requires a more recent version of WooCommerce and has been deactivated. Please update to the latest version of WooCommerce.	src/Domain/Bootstrap.php:129
Customer "new account" emails are sent to the customer when a customer signs up via checkout or account blocks.	“New Account” emails are sent when a customer signs up via the checkout flow.	src/Domain/Services/Email/CustomerNewAccount.php:58
Show a list of tags belonging to a product.	Display the list of tags that are assigned to a product.	assets/js/atomic/blocks/product-elements/tag-list/constants.js:14,build/all-products.js:28
Show a list of categories belonging to a product.	Display the list of categories that are assigned to a product.	build/all-products.js:28
Allow customers to filter the products by choosing a lower or upper price limit. Works in combination with the All Products block.	Enable customers to filter the product grid by choosing a price range.	assets/js/blocks/price-filter/index.js:29 build/price-filter.js:3
Show the currently active product filters. Works in combination with the All Products and filters blocks.	Display the currently active product filters..	assets/js/blocks/active-filters/index.js:29 build/active-filters.js:15
Allow customers to filter the grid by product attribute, such as color. Works in combination with the All Products block.	Enable customers to filter the product grid by selecting one or more attributes, such as color.	assets/js/blocks/attribute-filter/index.js:29 build/attribute-filter.js:37
Products will update as options are selected.	Products will update as soon as attributes are selected.	assets/js/blocks/attribute-filter/edit.js:200,assets/js/blocks/stock-filter/edit.js:93 build/attribute-filter.js:37,build/stock-filter.js:13
Showing Filter Products by Attribute block preview.	Now displaying a preview of the Filter Products by Attribute block.	assets/js/blocks/attribute-filter/edit.js:269 build/attribute-filter.js:37
We are currently working on improving our cart and checkout blocks to provide merchants with the tools and customization options they need.		assets/js/editor-components/feedback-prompt/index.js:56 build/cart.js:7,build/checkout.js:7
Enter the address that matches your card or payment method.	Enter the billing address that matches your payment method.	build/checkout-blocks/billing-address-frontend.js:1 build/checkout.js:34
This site is experiencing difficulties with this payment method. Please contact the owner of the site for assistance.	We are experiencing difficulties with this payment method. Please contact us for assistance.	assets/js/blocks/cart-checkout-shared/payment-methods/payment-method-error-boundary.js:26,build/cart-blocks/cart-express-payment-frontend.js:5 build/cart.js:5,build/checkout-blocks/express-payment-frontend.js:5,build/checkout-blocks/payment-frontend.js:5 build/checkout.js:5
Your store does not have any payment methods configured that support the checkout block. Once you have configured a compatible payment method it will be shown here.	Your store does not have any payment methods that support the Checkout block. Once you have configured a compatible payment method it will be displayed here.	assets/js/blocks/cart-checkout-shared/payment-methods/no-payment-methods/index.js:40,build/checkout-blocks/payment-frontend.js:5 build/checkout.js:36
The last inner block will be aligned vertically.	Align the last block to the bottom.	assets/js/editor-components/grid-layout-control/index.js:65,build/all-products.js:5 build/product-best-sellers.js:5,build/product-category.js:5 build/product-new.js:5,build/product-on-sale.js:5 build/product-tag.js:9,build/product-top-rated.js:5 build/products-by-attribute.js:15
Align Last Block	Align the last block to the bottom	assets/js/editor-components/grid-layout-control/index.js:59,build/all-products.js:5 build/product-best-sellers.js:5,build/product-category.js:5 build/product-new.js:5,build/product-on-sale.js:5 build/product-tag.js:9,build/product-top-rated.js:5 build/products-by-attribute.js:15
Edit the blocks inside the preview below to change the content displayed for each product within the product grid.	Edit the blocks inside the example below to change the content displayed for all products within the product grid.	assets/js/blocks/products/all-products/edit.js:210 build/all-products.js:36
Products with prices are needed for filtering by price. You haven't created any products yet.	To filter your products by price you first need to assign prices to your products.	assets/js/blocks/price-filter/edit.js:132 build/price-filter.js:3
Products will update when the slider is moved.	Products will update when the slider is moved.	assets/js/blocks/price-filter/edit.js:86 build/price-filter.js:3
Products will only update when the button is pressed.	Products will only update when the button is clicked.	assets/js/blocks/attribute-filter/edit.js:196,assets/js/blocks/price-filter/edit.js:82,assets/js/blocks/stock-filter/edit.js:89 build/attribute-filter.js:37,build/price-filter.js:3 build/stock-filter.js:13
Attributes are needed for filtering your products. You haven't created any attributes yet.	To filter your products by attribute you first need to assign attributes to your products.	assets/js/blocks/attribute-filter/edit.js:240 build/attribute-filter.js:37
Show a list of filters based on a chosen attribute.	Display a list of filters based on the selected attributes.	assets/js/blocks/attribute-filter/edit.js:234,assets/js/blocks/attribute-filter/edit.js:368 build/attribute-filter.js:37
Overlay a "sale" badge if the product is on-sale.	Display a “sale” badge if the product is on-sale.	assets/js/atomic/blocks/product-elements/image/edit.js:62,build/all-products.js:28
An unknown error occurred which prevented the block from being updated.	An error has prevented the block from being updated.	build/all-products.js:5 build/all-reviews.js:9 build/featured-category.js:6,build/featured-product.js:6 build/handpicked-products.js:5,build/product-best-sellers.js:5 build/product-category.js:5,build/product-new.js:5 build/product-on-sale.js:5,build/product-top-rated.js:5 build/products-by-attribute.js:5,build/reviews-by-category.js:13 build/reviews-by-product.js:13,build/single-product.js:5
Showing Reviews by Category block preview.	Now displaying a preview of the reviews for the products in the selected categories.	assets/js/blocks/reviews/reviews-by-category/edit.js:96,build/reviews-by-category.js:13
This block lists reviews for products from selected categories. The selected categories do not have any reviews yet, but they will show up here when they do.	This block displays reviews for products from the selected categories. Products from selected categories will be displayed when there are reviews for them.	assets/js/blocks/reviews/reviews-by-category/no-reviews-placeholder.js:22,build/reviews-by-category.js:13
Show reviews of your products to build trust.	Display reviews for your products.	assets/js/blocks/reviews/reviews-by-product/index.js:32,build/reviews-by-product.js:19
Your store doesn't have any product tags.	You have not set up any product tags on your store.	assets/js/editor-components/product-tag-control/index.js:110,build/product-tag.js:7
This block displays products from selected tags. In order to preview this you'll first need to create a product and assign it some tags.	This block displays products from selected tags. To use it you first need to create products and assign tags to them.	assets/js/blocks/product-tag/block.js:313 build/product-tag.js:9
This block shows product categories for your store. To use it, you'll first need to create a product and assign it to a category.	This block displays the product categories for your store. To use it you first need to create a product and assign it to a category.	assets/js/blocks/product-categories/block.js:29,build/product-categories.js:1
Visually highlight a product or variation and encourage prompt action	Highlight a product or variation.	assets/js/blocks/featured-product/block.js:177 build/featured-category.js:1,build/featured-product.js:1
Showing Hand-picked Products block preview.	Now displaying a preview of the Hand-picked Products block.	assets/js/blocks/handpicked-products/block.js:121,build/handpicked-products.js:7
Product image is hidden.	Remove	assets/js/editor-components/grid-content-control/index.js:27,build/handpicked-products.js:7 build/product-best-sellers.js:5,build/product-category.js:5 build/product-new.js:5,build/product-on-sale.js:5 build/product-tag.js:9,build/product-top-rated.js:5 build/products-by-attribute.js:15
Product image is visible.	Remove	assets/js/editor-components/grid-content-control/index.js:23,build/handpicked-products.js:7 build/product-best-sellers.js:5,build/product-category.js:5 build/product-new.js:5,build/product-on-sale.js:5 build/product-tag.js:9,build/product-top-rated.js:5 build/products-by-attribute.js:15
Something went wrong…	Something went wrong. Please contact us for assistance.	assets/js/blocks/cart/block.js:77 build/cart-frontend.js:6,build/checkout-frontend.js:6
Something went wrong. Please contact us to get assistance.	Something went wrong. Please contact us for assistance.	assets/js/base/context/providers/add-to-cart-form/form-state/index.js:249,assets/js/base/context/providers/add-to-cart-form/form/submit/index.js:104,assets/js/base/utils/errors.js:54 build/all-products.js:5,build/all-products.js:18 build/all-reviews.js:9 build/cart-frontend.js:1,build/cart-frontend.js:3 build/cart.js:1 build/checkout-frontend.js:1,build/checkout-frontend.js:3 build/checkout.js:1,build/featured-category.js:6 build/featured-product.js:6,build/handpicked-products.js:5,build/mini-cart-contents-block/footer--mini-cart-contents-block/products-table-frontend.js:1,build/mini-cart-contents.js:17 build/product-add-to-cart-frontend.js:1,build/product-add-to-cart.js:1 build/product-best-sellers.js:5,build/product-category.js:5 build/product-new.js:5,build/product-on-sale.js:5 build/product-top-rated.js:5,build/products-by-attribute.js:5 build/reviews-by-category.js:13,build/reviews-by-product.js:13 build/reviews-frontend.js:7,build/single-product-frontend.js:3 build/single-product.js:5,build/wc-blocks-data.js:3
Filter button	Remove	assets/js/blocks/attribute-filter/edit.js:190,assets/js/blocks/price-filter/edit.js:76,assets/js/blocks/stock-filter/edit.js:83 build/attribute-filter.js:37,build/price-filter.js:3 build/stock-filter.js:13
Or	Any	assets/js/blocks/attribute-filter/edit.js:159,assets/js/blocks/cart-checkout-shared/payment-methods/express-payment/cart-express-payment.js:69,build/attribute-filter.js:37,build/cart-blocks/cart-express-payment-frontend.js:5 build/cart.js:40
And	All	assets/js/blocks/attribute-filter/edit.js:152 build/attribute-filter.js:37
Query Type	Filter condition	assets/js/blocks/attribute-filter/edit.js:128 build/attribute-filter.js:37
Product count	Display product count	assets/js/blocks/attribute-filter/edit.js:83,assets/js/blocks/stock-filter/edit.js:38 build/attribute-filter.js:37,build/stock-filter.js:13
Label is hidden.	Remove	assets/js/blocks/product-search/edit.js:69 build/product-search.js:1
Label is visible.	Remove	assets/js/blocks/product-search/edit.js:65 build/product-search.js:1
Empty categories are hidden.	Remove	assets/js/blocks/product-categories/block.js:173,build/product-categories.js:1
Empty categories are visible.	Remove	assets/js/blocks/product-categories/block.js:169,build/product-categories.js:1
Hierarchy is hidden.	Remove	assets/js/blocks/product-categories/block.js:150,build/product-categories.js:1
Hierarchy is visible.	Remove	assets/js/blocks/product-categories/block.js:146,build/product-categories.js:1
Product count is hidden.	Remove	assets/js/blocks/attribute-filter/edit.js:93,assets/js/blocks/product-categories/block.js:106,assets/js/blocks/stock-filter/edit.js:48 build/attribute-filter.js:37,build/product-categories.js:1 build/stock-filter.js:13
Product count is visible.	Remove	assets/js/blocks/attribute-filter/edit.js:89,assets/js/blocks/product-categories/block.js:102,assets/js/blocks/stock-filter/edit.js:44 build/attribute-filter.js:37,build/product-categories.js:1 build/stock-filter.js:13
Add to Cart button is hidden.	Remove	assets/js/editor-components/grid-content-control/index.js:94,build/handpicked-products.js:7 build/product-best-sellers.js:5,build/product-category.js:5 build/product-new.js:5,build/product-on-sale.js:5 build/product-tag.js:9,build/product-top-rated.js:5 build/products-by-attribute.js:15
Add to Cart button is visible.	Remove	assets/js/editor-components/grid-content-control/index.js:90,build/handpicked-products.js:7 build/product-best-sellers.js:5,build/product-category.js:5 build/product-new.js:5,build/product-on-sale.js:5 build/product-tag.js:9,build/product-top-rated.js:5 build/products-by-attribute.js:15
Product rating is hidden.	Remove	assets/js/editor-components/grid-content-control/index.js:75,build/handpicked-products.js:7 build/product-best-sellers.js:5,build/product-category.js:5 build/product-new.js:5,build/product-on-sale.js:5 build/product-tag.js:9,build/product-top-rated.js:5 build/products-by-attribute.js:15
Product rating is visible.	Remove	assets/js/editor-components/grid-content-control/index.js:71,build/handpicked-products.js:7 build/product-best-sellers.js:5,build/product-category.js:5 build/product-new.js:5,build/product-on-sale.js:5 build/product-tag.js:9,build/product-top-rated.js:5 build/products-by-attribute.js:15
Product price is hidden.	Remove	assets/js/editor-components/grid-content-control/index.js:59,build/handpicked-products.js:7 build/product-best-sellers.js:5,build/product-category.js:5 build/product-new.js:5,build/product-on-sale.js:5 build/product-tag.js:9,build/product-top-rated.js:5 build/products-by-attribute.js:15
Product price is visible.	Remove	assets/js/editor-components/grid-content-control/index.js:55,build/handpicked-products.js:7 build/product-best-sellers.js:5,build/product-category.js:5 build/product-new.js:5,build/product-on-sale.js:5 build/product-tag.js:9,build/product-top-rated.js:5 build/products-by-attribute.js:15
Product title is hidden.	Remove	assets/js/editor-components/grid-content-control/index.js:43,build/handpicked-products.js:7 build/product-best-sellers.js:5,build/product-category.js:5 build/product-new.js:5,build/product-on-sale.js:5 build/product-tag.js:9,build/product-top-rated.js:5 build/products-by-attribute.js:15
Product title is visible.	Remove	assets/js/editor-components/grid-content-control/index.js:39,build/handpicked-products.js:7 build/product-best-sellers.js:5,build/product-category.js:5 build/product-new.js:5,build/product-on-sale.js:5 build/product-tag.js:9,build/product-top-rated.js:5 build/products-by-attribute.js:15

[senadir]

Hey! Cart block recently switched from using OR to ANY, any reason for that? it's now more ambiguous than it was
@ifinoi

[sunyatasattva]

Hey @senadir, this was an oversight by us. We have changed an “OR” statement that was referring to a query type filter within our blocks (see line 751 of this Google Sheet, though a better comment is in this Google Doc), and this string was caught in the change.

We did review our changes quite closely, but this was a slip-up. Apologies!