Dynamic fragment
Re-renders WooCommerce cart-dependent content after cart changes.
Where this element works
Section titled “Where this element works”WooCommerce-aware Bricks layouts, such as page content, headers, and footers that need to update after cart changes.
Key settings
Section titled “Key settings”- Insert a structure (select) - Choose a generated starter structure.
- Generate (button) - Adds the selected structure to the element.
Generated structures
Section titled “Generated structures”- Mini cart
- Free shipping progress
Generated structures are appended to the current content and do not overwrite existing content.

Usage tips
Section titled “Usage tips”- Use Dynamic fragment for cart-dependent content outside the main Cart page, such as a custom mini cart, free shipping progress, or cart totals.
- Keep the fragment focused on content that needs to refresh after add-to-cart, remove-from-cart, or quantity changes.
- Keep the Dynamic fragment wrapper outside other query loops. A cart loop can be placed inside the fragment.
Free shipping progress
Section titled “Free shipping progress”The Free shipping progress structure adds a Progress Bar that shows how much more the cart needs for free shipping. Place the Dynamic fragment where shoppers see it on every page, for example a bar at the top of the header template, so it updates as products are added.
- Minimum amount: Bricks reads it from WooCommerce. It is the Minimum order amount of the Free shipping method in the shipping zone that matches the cart, with Free shipping requires set to a minimum order amount (alone or combined with a coupon). Change it in WooCommerce > Settings > Shipping, not in Bricks. If several free shipping methods match, Bricks uses the one with the smallest remaining amount.
- Cart amount: the cart subtotal minus coupon discounts, unless Apply minimum order rule before coupon discount is enabled on the free shipping method.
- Label:
Add {woo_free_shipping_remaining} more for free shipping. - Value:
{woo_free_shipping_progress:value}, a number from 0 to 100 (the percentage of the minimum the cart has reached). - Conditions: the bar only renders while a minimum exists (
{woo_free_shipping_min_amount:value}is not 0) and the cart is below it ({woo_free_shipping_progress:value}is less than 100).
Once the cart reaches the minimum, the bar is hidden. The structure has no message for that state. To show one, add an element such as Basic Text inside the same Dynamic fragment and give it the condition Dynamic data {woo_free_shipping_progress:value} == 100.

The Builder canvas previews a sample cart, so the bar can show “Add $0.00 more” and the conditions are not applied there. Check the real amounts on the frontend with products in the cart.
Custom mini cart
Section titled “Custom mini cart”For a mini cart, add a Dynamic fragment inside an Offcanvas in the header template and generate the Mini cart structure. A second Dynamic fragment in the header holds the cart icon and item count, so the count updates too. Create a custom mini cart with Dynamic fragment walks through the full setup, including the interactions that open the panel.
See WooCommerce v2 query loops and dynamic tags for the cart tags you can use inside the fragment.
Refresh behavior
Section titled “Refresh behavior”Dynamic fragment refreshes after WooCommerce cart, coupon, and checkout events such as add to cart, remove from cart, cart emptied, cart totals updated, checkout updated, and coupon apply/remove events.
After a refresh, Bricks reruns frontend functions and dispatches:
document.body.addEventListener('bricks/woocommerce/fragments/refreshed', (event) => { console.log(event.detail.fragments)})This refresh event also covers initial synchronization and checkout recalculations that do not change cart items. For a custom success notice or popup, use the Bricks cart contents changed interaction trigger, available since Bricks 2.4. It runs after a confirmed AJAX addition, removal, or quantity change and the related UI updates finish.
Limitations
Section titled “Limitations”- Dynamic fragment is frontend-only.
- Do not place the Dynamic fragment wrapper inside a query loop.
- Component instances are not supported.
- The source area must be header, content, or footer.
Was this helpful?
A quick vote and short notes help us improve these docs faster.
Leave a note for us
Please do not include passwords, license keys, or personal data. We store submitted notes to improve the docs.
Thanks for sharing feedback. We're using it to improve these docs.