classic-woocommerce-theme-support

Classic WooCommerce Theme Support

Use this when creating or reviewing a classic PHP theme that must support WooCommerce shop, taxonomy, product, cart, checkout, and account screens.

This is not a block-theme skill. If the theme uses HTML block templates or the Site Editor as its primary rendering model, use Woo block-theme documentation instead.

When to Use This Skill

• Adding WooCommerce compatibility to a classic theme.
• Fixing a shop page that renders through unsupported shortcode/content fallback.
• Aligning Woo wrappers with the theme's page.php/single.php structure.
• Setting Woo image sizes, product grid defaults, or gallery features.
• Loading frontend assets only on Woo screens.
• Reviewing whether a theme should override Woo templates at all.

Declare Support

Declare WooCommerce support on after_setup_theme.

add_action( 'after_setup_theme', 'mytheme_woocommerce_support' );

function mytheme_woocommerce_support() {
	add_theme_support(
		'woocommerce',
		array(
			'thumbnail_image_width' => 360,
			'single_image_width'    => 720,
			'product_grid'          => array(
				'default_rows'    => 4,
				'min_rows'        => 2,
				'max_rows'        => 6,
				'default_columns' => 3,
				'min_columns'     => 2,
				'max_columns'     => 4,
			),
		)
	);
}

Rules:

• A classic theme that ships Woo template overrides must declare Woo support.
• Without support, Woo treats the theme as unsupported and uses fallback content rendering for shop/product pages.
• wc_current_theme_supports_woocommerce_or_fse() returns true when the classic theme supports Woo or when the active theme is a block theme.
• Do not declare support from a plugin unless the plugin truly owns the active theme.

Image Sizes

Woo reads theme support values through wc_get_theme_support() and wc_get_image_size().

Supported keys:

• thumbnail_image_width for catalog/grid images.
• single_image_width for single product main images.
• gallery_thumbnail_image_width for gallery thumbnails.