plugins/woocommerce/client/blocks/docs/designers/theming/class-names-update-280.md
In WooCommerce Blocks 2.8.0, we replaced and deprecated some some class names to simplify them, fix inconsistencies, and make it easier to differentiate frontend components from editor components.
Some classes that were introduced in 2.6.0 and 2.7.0 and didn't ship in WooCommerce Core have been replaced by new ones. They can be found in this table:
| Removed | New class name |
|---|---|
wc-block-address-form | wc-block-components-address-form |
wc-block-checkout-form | wc-block-components-checkout-form |
wc-block-checkout-step | wc-block-components-checkout-step |
wc-block-cart__payment-method-icons | wc-block-components-payment-method-icons |
wc-blocks-payment-method-icon | wc-block-components-payment-method-icon |
wc-block-cart__payment-method-label | wc-block-components-payment-method-label |
wc-block-low-stock-badge | wc-block-components-product-low-stock-badge |
wc-block-product-metadata | wc-block-components-product-metadata |
wc-block-product-name | wc-block-components-product-name |
wc-block-product-price | wc-block-components-product-price |
wc-block-product-price--regular | wc-block-components-product-price__regular |
wc-block-sale-badge | wc-block-components-sale-badge |
wc-block-product-variation-data | wc-block-components-product-variation-data |
wc-block-cart__shipping-calculator | wc-block-components-shipping-calculator |
wc-block-shipping-calculator | wc-block-components-shipping-calculator |
wc-block-cart__shipping-address | wc-block-components-shipping-address |
wc-block-shipping-rates-control | wc-block-components-shipping-rates-control |
wc-block-coupon-code | wc-block-components-totals-coupon |
wc-block-cart-coupon-list | wc-block-components-totals-discount__coupon-list |
wc-block-totals-footer-item | wc-block-components-totals-footer-item |
wc-block-totals-table-item | wc-block-components-totals-item |
wc-block-shipping-totals | wc-block-components-totals-shipping |
wc-block-checkbox | wc-block-components-checkbox |
wc-block-country-input | wc-block-components-country-input |
wc-block-loading-mask | wc-block-components-loading-mask |
wc-blocks-loading-mask__children | wc-block-components-loading-mask__children |
wc-block-quantity-selector | wc-block-components-quantity-selector |
wc-block-radio-control | wc-block-components-radio-control |
wc-block-select | wc-block-components-select |
wc-block-main | wc-block-components-main |
wc-block-sidebar-layout | wc-block-components-sidebar-layout |
wc-block-sidebar | wc-block-components-sidebar |
wc-block-notices__snackbar | wc-block-components-notices__snackbar |
wc-block-text-input | wc-block-components-text-input |
wc-block-component__title | wc-block-components-title |
wc-block-form-input-validation-error | wc-block-components-validation-error |
wc-block-checkout__save-card-info | wc-block-components-payment-methods__save-card-info |
Note: If not listed, all items in the table above include derived classes.
For example, given that wc-block-address-form changed to wc-block-components-address-form:
wc-block-address-form__company also changed to wc-block-components-address-form__companywc-block-address-form__address_1 also changed to wc-block-components-address-form__address_1In most cases, it should be safe to do a search & replace in the stylesheet replacing the removed class names with the new ones.
Some classes that were introduced in previous versions or that have shipped in WooCommerce Core, have not been removed but are deprecated. Those classes will not be removed until the next major version but all themes are encouraged to update to the new ones as soon as possible:
| Deprecated | New class name |
|---|---|
wc-block-error | wc-block-components-error |
wc-block-product-sort-select | wc-block-components-product-sort-select |
wc-block-formatted-money-amount | wc-block-components-formatted-money-amount |
wc-block-checkbox-list | wc-block-components-checkbox-list |
wc-block-dropdown-selector | wc-block-components-dropdown-selector |
wc-block-filter-submit-button | wc-block-components-filter-submit-button |
wc-block-load-more | wc-block-components-load-more |
wc-block-pagination | wc-block-components-pagination |
wc-block-pagination-page | wc-block-components-pagination__page |
wc-block-pagination-ellipsis | wc-block-components-pagination__ellipsis |
wc-block-review-list | wc-block-components-review-list |
wc-block-review-sort-select | wc-block-components-review-sort-select |
wc-block-price-filter | wc-block-components-price-slider |
wc-block-form-text-input | wc-block-components-price-slider__amount |
Note: if not listed, all items in the table above include derived classes.
For example, given that wc-block-error changed to wc-block-components-error
wc-block-error__company also changed to wc-block-components-error__contentwc-block-error__address_1 also changed to wc-block-components-error__imageWe're hiring! Come work with us!
š Found a mistake, or have a suggestion? Leave feedback about this document here.
<!-- /FEEDBACK -->