How to customize WooCommerce thank-you pages

WooCommerce calls this the order-received page. Decide whether you only need extra text or tracking, a redesigned layout, a redirect, or different content for different orders.

Extra text and small additions are usually fine with hooks. A full layout change needs a template override or a page-builder-style plugin. Product-, category-, payment-method- and order-based rules are where manual code becomes harder to maintain.

Find out whether the store uses the classic checkout shortcode or the Checkout block. Newer WooCommerce stores commonly use Cart and Checkout blocks, while older stores may still use the shortcode. The checkout editor changes the checkout itself; it does not automatically give you a complete conditional thank-you-page system.

The thank-you page normally appears at the checkout’s order-received endpoint. It is not usually a separate page that you can open and edit from Pages, so do not create a second page until you have decided whether you are adding content, overriding the template or redirecting customers.

For a custom message near the order-received text, use the woocommerce_thankyou_order_received_text filter. For content or tracking after the order confirmation output, use the woocommerce_thankyou action. WooCommerce passes the order ID to the action, which lets your code read the order total, products and other order data.

Put the code in a child theme’s functions.php file or a code-snippet plugin, not the parent theme. Keep the message useful: delivery information, account instructions, a support contact or one relevant next step. Avoid printing private order data without checking the current order and customer context.

For structural changes, copy WooCommerce’s wp-content/plugins/woocommerce/templates/checkout/thankyou.php file into wp-content/themes/your-child-theme/woocommerce/checkout/thankyou.php, then edit the copied file. WooCommerce loads the copy from the theme instead of the plugin’s original template.

This is safer than editing the plugin, but it creates maintenance work. WooCommerce can update the original template while your copy stays unchanged, so check the WooCommerce system-status template warnings after updates and merge relevant changes. A template override is best for a developer-controlled layout, not for store staff who need to change campaigns regularly.

A redirect can send customers to a normal WordPress page, landing page or product-specific destination, but it can also remove the standard order number, billing details, shipping details and payment instructions unless you rebuild them. The redirect must also preserve the correct order context and avoid running on unrelated checkout requests.

If you use custom PHP for a redirect, check the order-received endpoint and the order key before redirecting. Do not redirect failed or unpaid orders to a success page, and do not rely on a JavaScript redirect added after WooCommerce has already started rendering the response.

Place test orders for a successful payment, a failed payment and any pending or manual payment method you use. Check the page as a guest and a logged-in customer, then refresh the order-received URL to make sure the message or offer does not create duplicate orders or repeated tracking events.

Also test mobile layout, order details, downloadable products, tax and shipping text, and any payment gateway instructions. If the page shows a 404, review the checkout page and endpoint settings, then save the permalink settings once to refresh rewrite rules. If you need conditional pages, coupons, surveys, upsells and analytics without maintaining these cases yourself, the fast route is WPC Smart Thank You Page for WooCommerce. It is designed for targeted post-purchase pages based on products, categories, payment methods or order values.