Commit dbd35f1f252 for woocommerce

commit dbd35f1f2529683f7d05552071fc0c74897d78c0
Author: Brian Coords <bacoords@gmail.com>
Date:   Mon Jun 29 11:56:54 2026 -0700

    Add cart checkout template guidance (#65952)

    * Add cart checkout template guidance

    * Update cart checkout template docs

diff --git a/docs/theming/block-theme-development/cart-and-checkout.md b/docs/theming/block-theme-development/cart-and-checkout.md
index 6035e7bb1f4..5fa95e67d3f 100644
--- a/docs/theming/block-theme-development/cart-and-checkout.md
+++ b/docs/theming/block-theme-development/cart-and-checkout.md
@@ -9,6 +9,7 @@ sidebar_label: Cart and Checkout blocks theming
 > [!IMPORTANT]
 > We strongly discourage writing CSS code based on existing block class names and prioritize using global styles when possible. We especially discourage writing CSS selectors that rely on a specific block being a descendant of another one, as users can move blocks around freely, so they are prone to breaking. Similar to WordPress itself, we consider the HTML structure within components, blocks, and block templates to be "private", and subject to further change in the future, so using CSS to target the internals of a block or a block template is _not recommended or supported_.

+If your theme overrides `page-cart.html` or `page-checkout.html`, keep the Cart and Checkout blocks in the assigned page content and render that content from the template with `core/post-content`. See [Cart and Checkout page templates](/docs/theming/block-theme-development/theming-woo-blocks#cart-and-checkout-page-templates) for the recommended template structure.

 ## Buttons

@@ -81,6 +82,3 @@ By default, it uses a combination of black and white borders and shadows so it h
 ```

 ![Order summary screenshot with custom styles for the item quantity badge](https://user-images.githubusercontent.com/3616980/83863109-2e421c80-a723-11ea-9bf7-2033a96cf5b2.png)
-
-
-
diff --git a/docs/theming/block-theme-development/theming-woo-blocks.md b/docs/theming/block-theme-development/theming-woo-blocks.md
index 03fe7d4384f..cfd5b515fff 100644
--- a/docs/theming/block-theme-development/theming-woo-blocks.md
+++ b/docs/theming/block-theme-development/theming-woo-blocks.md
@@ -38,6 +38,39 @@ Block themes can customize those templates in the following ways:
 - It's possible to create templates for specific products and taxonomies. For example, if the theme provides a template with file name of `single-product-cap.html`, that template will be used when rendering the product with slug `cap`. Similarly, themes can provide specific taxonomy templates: `taxonomy-product_cat-clothing.html` would be used in the product category with slug `clothing`.
 - Always keep in mind users can make modifications to the templates provided by the theme via the Site Editor.

+#### Cart and Checkout page templates
+
+The `page-cart.html` and `page-checkout.html` templates should render the content from the assigned Cart and Checkout pages. Add layout, headers, footers, and other template-level content around the page content, but keep the Cart and Checkout blocks in the corresponding page content.
+
+WooCommerce's default `page-cart.html` template uses the `woocommerce/page-content-wrapper` block with `woocommerce/store-notices`, `core/post-title`, and `core/post-content` inside it:
+
+```html
+<!-- wp:woocommerce/page-content-wrapper {"page":"cart"} -->
+<!-- wp:group {"tagName":"main","layout":{"type":"constrained"}} -->
+<main class="wp-block-group">
+    <!-- wp:woocommerce/store-notices /-->
+    <!-- wp:post-title {"align":"wide", "level":1} /-->
+    <!-- wp:post-content {"align":"wide"} /-->
+</main>
+<!-- /wp:group -->
+<!-- /wp:woocommerce/page-content-wrapper -->
+```
+
+The default `page-checkout.html` template uses the same wrapper and store notices, but renders page content without a page title:
+
+```html
+<!-- wp:woocommerce/page-content-wrapper {"page":"checkout"} -->
+<!-- wp:group {"tagName":"main","layout":{"type":"constrained"}} -->
+<main class="wp-block-group">
+    <!-- wp:woocommerce/store-notices /-->
+    <!-- wp:post-content {"align":"wide"} /-->
+</main>
+<!-- /wp:group -->
+<!-- /wp:woocommerce/page-content-wrapper -->
+```
+
+Use the same pattern when overriding `page-cart.html` or `page-checkout.html` in a theme. Avoid placing `woocommerce/cart` or `woocommerce/checkout` directly in these template files as a replacement for `core/post-content`. If the template bypasses page content, the page editor can become out of sync with what shoppers see, and WooCommerce features that inspect the assigned page content may not detect the Cart or Checkout block correctly.
+
 ### Block template parts

 WooCommerce also comes with two specific [block template parts](https://github.com/woocommerce/woocommerce/tree/trunk/plugins/woocommerce/templates/parts):