Using the Caddy Cart block

Caddy 3.0 introduces a dedicated Caddy Smart Side Cart block, built on the WordPress Interactivity API and the WooCommerce Store API. In most stores you’ll never need to think about it — Caddy adds the cart to every page automatically. But if you use a block theme or build pages in the editor, the block gives you direct control.

Do I need to add the block?

No. Caddy automatically inserts the cart on your storefront. The block exists for cases where you want to place or configure it explicitly — for example in a block theme’s template, or on a specific landing page.

Adding the block

1. Edit the page, template, or template part where you want the cart.
2. Click the + inserter and search for “Caddy”.
3. Add the Caddy Smart Side Cart block.

Block settings

• Cart text — the label shown with the cart trigger (default “Cart”).
• Show icon — show or hide the cart icon.
• Auto-open — whether the cart drawer slides open automatically when a customer adds a product (on by default).

What renders on the front end

The block outputs the complete Caddy experience: the floating cart bubble with a live item count, and the slide-in cart drawer with cart items, quantity controls, the free shipping / rewards meter, product recommendations, saved items, the coupon field, and the checkout button — each appearing according to your Caddy settings.

Because it’s built on the Interactivity API, the initial cart state is server-rendered (no blank flash or loading spinner) and updates re-render only the fragments that changed. The block works in any theme — classic or block-based — and requires no jQuery.

To add a cart link to a menu or to any spot a block won’t reach, you can still use the [cc_cart_items] and [cc_saved_items] shortcodes — see adding a Caddy cart widget to your header.