{"id":38201,"date":"2015-08-17T14:43:15","date_gmt":"2015-08-17T14:43:15","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/wc-custom-thank-you\/"},"modified":"2026-03-24T22:36:03","modified_gmt":"2026-03-24T22:36:03","slug":"wc-custom-thank-you","status":"publish","type":"plugin","link":"https:\/\/eu.wordpress.org\/plugins\/wc-custom-thank-you\/","author":14834133,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"2.1.0","stable_tag":"2.1.0","tested":"6.9.4","requires":"6.5","requires_php":"7.4","requires_plugins":null,"header_name":"Custom Thank You Page for WooCommerce","header_author":"Riaan Knoetze","header_description":"","assets_banners_color":"828dae","last_updated":"2026-03-24 22:36:03","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/wordpress.org\/plugins\/wc-custom-thank-you\/","header_author_uri":"https:\/\/profiles.wordpress.org\/riaanknoetze\/","rating":5,"author_block_rating":0,"active_installs":2000,"downloads":50351,"num_ratings":7,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"nicolamustone","date":"2015-08-17 14:45:58"},"1.1.0":{"tag":"1.1.0","author":"nicolamustone","date":"2017-02-01 15:50:07"},"1.2.0":{"tag":"1.2.0","author":"nicolamustone","date":"2017-04-05 12:57:13"},"1.2.1":{"tag":"1.2.1","author":"nicolamustone","date":"2018-07-19 10:10:23"},"2.0.0":{"tag":"2.0.0","author":"riaanknoetze","date":"2026-01-01 17:34:14"},"2.1.0":{"tag":"2.1.0","author":"riaanknoetze","date":"2026-03-24 22:36:03"}},"upgrade_notice":[],"ratings":{"1":0,"2":0,"3":0,"4":0,"5":"7"},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3430658,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3430658,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.jpg":{"filename":"banner-1544x500.jpg","revision":3430658,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.jpg":{"filename":"banner-772x250.jpg","revision":3430658,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":{"wccty\/block-wc-custom-thank-you":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"wccty\/block-wc-custom-thank-you","version":"0.1.0","title":"Order Confirmation","category":"woocommerce","icon":"feedback","description":"Display complete WooCommerce order details including items, totals, and customer information.","example":{},"attributes":{"accentColor":{"type":"string","default":"#4caf50"},"accentTextColor":{"type":"string","default":"#ffffff"},"sectionBackgroundColor":{"type":"string","default":"#f9f9f9"},"paymentBackgroundColor":{"type":"string","default":"#e3f2fd"},"paymentBorderColor":{"type":"string","default":"#2196f3"},"paymentTextColor":{"type":"string","default":"#333333"}},"supports":{"html":false,"multiple":false,"color":{"background":true,"text":true},"typography":{"fontSize":true,"lineHeight":true},"spacing":{"padding":true,"margin":true},"border":{"color":true,"radius":true,"width":true}},"textdomain":"wc-custom-thank-you","editorScript":"file:.\/index.js","editorStyle":"file:.\/index.css","style":"file:.\/style-index.css","render":"file:.\/render.php"}},"tagged_versions":["1.0.0","1.1.0","1.2.0","1.2.1","2.0.0","2.1.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3430658,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3430658,"resolution":"2","location":"assets","locale":""},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3430658,"resolution":"3","location":"assets","locale":""},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3430658,"resolution":"4","location":"assets","locale":""}},"screenshots":{"1":"Custom thank you (order confirmation) page setup","2":"Thank You page block setup","3":"Front-end thank you page (classic display)","4":"Front-end thank you page (block display)"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[142106,198198,253133,228105,286],"plugin_category":[43,45],"plugin_contributors":[83604,252203],"plugin_business_model":[],"class_list":["post-38201","plugin","type-plugin","status-publish","hentry","plugin_tags-custom-thank-you-page","plugin_tags-order-confirmation-page","plugin_tags-order-received-page","plugin_tags-woo-thank-you-page","plugin_tags-woocommerce","plugin_category-customization","plugin_category-ecommerce","plugin_contributors-nicolamustone","plugin_contributors-riaanknoetze","plugin_committers-nicolamustone","plugin_committers-riaanknoetze"],"banners":{"banner":"https:\/\/ps.w.org\/wc-custom-thank-you\/assets\/banner-772x250.jpg?rev=3430658","banner_2x":"https:\/\/ps.w.org\/wc-custom-thank-you\/assets\/banner-1544x500.jpg?rev=3430658","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/wc-custom-thank-you\/assets\/icon-128x128.png?rev=3430658","icon_2x":"https:\/\/ps.w.org\/wc-custom-thank-you\/assets\/icon-256x256.png?rev=3430658","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/wc-custom-thank-you\/assets\/screenshot-1.png?rev=3430658","caption":"Custom thank you (order confirmation) page setup"},{"src":"https:\/\/ps.w.org\/wc-custom-thank-you\/assets\/screenshot-2.png?rev=3430658","caption":"Thank You page block setup"},{"src":"https:\/\/ps.w.org\/wc-custom-thank-you\/assets\/screenshot-3.png?rev=3430658","caption":"Front-end thank you page (classic display)"},{"src":"https:\/\/ps.w.org\/wc-custom-thank-you\/assets\/screenshot-4.png?rev=3430658","caption":"Front-end thank you page (block display)"}],"raw_content":"<!--section=description-->\n<p>The WooCommerce \"thank you\" page (order confirmation \/ order received page) is one of the most important pages in your store: it\u2019s where customers look for confirmation, next steps, downloads, shipping info, and payment instructions.<\/p>\n\n<p><strong>Custom Thank You Page for WooCommerce<\/strong> lets you replace the default WooCommerce Thank You page with a page you fully control \u2014 so you can deliver a branded order confirmation experience that matches your store and your audience.<\/p>\n\n<h4>Attribution<\/h4>\n\n<p>This plugin was originally created and maintained by <a href=\"https:\/\/profiles.wordpress.org\/nicolamustone\/\">Nicola Mustone<\/a>. You should definitely check out his blog <a href=\"https:\/\/buthonestly.io\/\">\"But. Honestly\"<\/a>.<\/p>\n\n<h4>Why you\u2019ll love it<\/h4>\n\n<ul>\n<li><strong>Choose any WordPress page<\/strong> as your custom WooCommerce Thank You page.<\/li>\n<li><strong>Automatic redirect after checkout<\/strong> (customers land on your custom order confirmation page).<\/li>\n<li><strong>Block-based order confirmation<\/strong>: add the included <strong>Order Confirmation<\/strong> block (Gutenberg \/ Site Editor \/ FSE) to show complete order details.<\/li>\n<li><strong>Shortcode support<\/strong>: use <code>[wc_custom_thankyou]<\/code> if you prefer explicit placement (classic editor, templates, builders, etc).<\/li>\n<li><strong>Compatible by design<\/strong>: uses WooCommerce core logic and the default <code>checkout\/thankyou.php<\/code> template when needed, so it stays aligned with WooCommerce updates.<\/li>\n<li><strong>Modern WooCommerce compatibility<\/strong>: declared compatible with <strong>HPOS<\/strong> (High-Performance Order Storage) and <strong>Cart &amp; Checkout blocks<\/strong>.<\/li>\n<\/ul>\n\n<h4>Use cases (what you can build)<\/h4>\n\n<p>Turn your custom thank you page into a conversion, support, and retention asset:<\/p>\n\n<ul>\n<li>Add a personalized thank you message and \u201cwhat happens next\u201d<\/li>\n<li>Upsell\/cross-sell related products after purchase<\/li>\n<li>Display delivery timeframes, FAQ, support links, and onboarding steps<\/li>\n<li>Add download instructions, community invites, or account setup links<\/li>\n<li>Add custom tracking scripts or conversion snippets (where appropriate)<\/li>\n<\/ul>\n\n<h4>How it works<\/h4>\n\n<ol>\n<li>Customer completes checkout.<\/li>\n<li>WooCommerce redirects to its standard Order Received page.<\/li>\n<li>This plugin safely redirects them to your configured custom Thank You page (keeping the required order context).<\/li>\n<li>Your page can display the order confirmation details automatically, via shortcode, or via the block.<\/li>\n<\/ol>\n\n<h4>Configuration (2 minutes)<\/h4>\n\n<ol>\n<li>Go to <strong>WooCommerce \u2192 Settings \u2192 Advanced<\/strong><\/li>\n<li>Find <strong>Custom Thank You<\/strong><\/li>\n<li>Select your <strong>Thank You Page<\/strong> and save<\/li>\n<\/ol>\n\n<h4>Block + Shortcode options<\/h4>\n\n<ul>\n<li><strong>Block (recommended for block themes \/ Site Editor):<\/strong> On your custom Thank You page, add the <strong>Order Confirmation<\/strong> block.<\/li>\n<li><strong>Shortcode:<\/strong> Add <code>[wc_custom_thankyou]<\/code> where you want the order confirmation details to appear.<\/li>\n<\/ul>\n\n<p>If you do nothing else, the plugin will append the standard WooCommerce Thank You template output to your page content (for backwards compatibility).<\/p>\n\n<h4>Support<\/h4>\n\n<p>Support is best-effort. If you run into an issue, please include:<\/p>\n\n<ul>\n<li>Your WordPress + WooCommerce versions<\/li>\n<li>Your theme name (and whether it\u2019s a block theme)<\/li>\n<li>The exact steps to reproduce<\/li>\n<\/ul>\n\n<h4>Get involved<\/h4>\n\n<p>If you want to help, consider <a href=\"https:\/\/translate.wordpress.org\/projects\/wp-plugins\/wc-custom-thank-you\/\">translating the plugin into your language<\/a>.<\/p>\n\n<!--section=installation-->\n<h4>Minimum Requirements<\/h4>\n\n<ul>\n<li>WordPress 6.5 or greater<\/li>\n<li>PHP 7.4 or greater<\/li>\n<li>MySQL 5.6 or greater (or MariaDB equivalent)<\/li>\n<li>WooCommerce 8.0 or greater<\/li>\n<\/ul>\n\n<h4>Automatic installation<\/h4>\n\n<ol>\n<li>Log in to your WordPress dashboard<\/li>\n<li>Go to <strong>Plugins \u2192 Add New<\/strong><\/li>\n<li>Search for <strong>\u201cCustom Thank You Page for WooCommerce\u201d<\/strong><\/li>\n<li>Click <strong>Install Now<\/strong>, then <strong>Activate<\/strong><\/li>\n<\/ol>\n\n<h4>Manual installation<\/h4>\n\n<p>Download the plugin and upload it to your server. The WordPress documentation contains <a href=\"https:\/\/wordpress.org\/documentation\/article\/managing-plugins\/#manual-plugin-installation\">instructions on how to do this here<\/a>.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id=\"i%20receive%20a%20php%20error%20on%20my%20custom%20thank%20you%20page.%20why%3F\"><h3>I receive a PHP error on my custom Thank You page. Why?<\/h3><\/dt>\n<dd><p>Make sure you are running:<\/p>\n\n<ul>\n<li>WordPress 6.5 or newer<\/li>\n<li>WooCommerce 8.0 or newer<\/li>\n<li>PHP 7.4 or newer<\/li>\n<\/ul>\n\n<p>Also ensure:<\/p>\n\n<ul>\n<li>The <strong>Thank You Page<\/strong> option in <strong>WooCommerce \u2192 Settings \u2192 Advanced<\/strong> is set to an existing published page<\/li>\n<li>You are viewing the page after a real checkout, so the URL includes the required order context<\/li>\n<\/ul><\/dd>\n<dt id=\"my%20custom%20page%20shows%2C%20but%20the%20order%20confirmation%20details%20do%20not.\"><h3>My custom page shows, but the order confirmation details do not.<\/h3><\/dt>\n<dd><p>Order details only appear when the request contains valid order data (the <code>order<\/code> and <code>key<\/code> parameters). The plugin adds these automatically after checkout.<\/p>\n\n<p>To test: place a real order, then you\u2019ll be redirected to your custom order confirmation page with the correct URL parameters.<\/p><\/dd>\n<dt id=\"should%20i%20use%20the%20block%2C%20the%20shortcode%2C%20or%20%E2%80%9Cautomatic%E2%80%9D%20output%3F\"><h3>Should I use the block, the shortcode, or \u201cautomatic\u201d output?<\/h3><\/dt>\n<dd><ul>\n<li><strong>Use the block<\/strong> if you\u2019re building a modern block-based thank you page (Gutenberg \/ FSE) and you want a dedicated order confirmation layout.<\/li>\n<li><strong>Use the shortcode<\/strong> if you want explicit placement inside page builders, templates, or classic content.<\/li>\n<li><strong>Automatic output<\/strong> is best for simple setups: your content stays, and WooCommerce\u2019s default thank you template is appended.<\/li>\n<\/ul><\/dd>\n<dt id=\"will%20payment%20instructions%20from%20gateways%20still%20work%3F\"><h3>Will payment instructions from gateways still work?<\/h3><\/dt>\n<dd><p>Yes. When the Order Confirmation block is used, the plugin avoids duplicating WooCommerce\u2019s legacy order details markup, but still runs WooCommerce \u201cthankyou\u201d hooks so payment gateways and extensions can output instructions as expected.<\/p><\/dd>\n<dt id=\"can%20i%20customize%20the%20templates%3F\"><h3>Can I customize the templates?<\/h3><\/dt>\n<dd><p>When using automatic output \/ shortcode, this plugin uses WooCommerce\u2019s default <code>checkout\/thankyou.php<\/code> template. You can override and customize it in your theme or child theme. Learn how here: https:\/\/woo.com\/document\/template-structure\/<\/p><\/dd>\n<dt id=\"i%20have%20a%20custom%20language%20file.%20where%20do%20i%20save%20it%3F\"><h3>I have a custom language file. Where do I save it?<\/h3><\/dt>\n<dd><p>This plugin loads language files from:<\/p>\n\n<ul>\n<li><code>wp-content\/languages\/wc-custom-thank-you\/wc-custom-thank-you-{YOURLOCALE}.mo<\/code><\/li>\n<li><code>wp-content\/languages\/plugins\/wc-custom-thank-you-{YOURLOCALE}.mo<\/code><\/li>\n<li><code>wp-content\/plugins\/wc-custom-thank-you\/languages\/<\/code><\/li>\n<\/ul>\n\n<p>Put your custom language files in one of these locations (<strong>the first one is recommended<\/strong>). If you save the files in the last location you will lose them when updating the plugin.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>2.1.0 - 2026-03-24<\/h4>\n\n<ul>\n<li>New - WC Version compatibility<\/li>\n<li>Fix - Readme fixes<\/li>\n<\/ul>\n\n<h4>2.0.0 - 2026-01-01<\/h4>\n\n<ul>\n<li>New - Completely rewritten codebase<\/li>\n<li>New - WooCommerce compatibility<\/li>\n<li>New - Tested with WordPress 6.9<\/li>\n<li>New - Added an Order Confirmation block for Gutenberg \/ Site Editor (FSE) to display complete order details<\/li>\n<li>New - Declared compatibility with WooCommerce High-Performance Order Storage (HPOS)<\/li>\n<li>New - Declared compatibility with WooCommerce Cart &amp; Checkout blocks<\/li>\n<li>New - Added a Settings link on the Plugins screen for faster access<\/li>\n<li>New - Localization for popular languages (Arabic, Danish, German, Greek, Spanish, Finnish, French, Hebrew, Indonesian, Italian, Japanese, Korean, Dutch, Portuguese, Russian, Swedish, Turkish, and Chinese)<\/li>\n<li>Update - Shortcode support: <code>[wc_custom_thankyou]<\/code><\/li>\n<li>Update - Refactored codebase for modern WooCommerce versions and APIs<\/li>\n<li>Update - Limited <code>the_content<\/code> filter to the configured Thank You page only, to reduce overhead on the rest of the site<\/li>\n<li>Update - text domain to <code>wc-custom-thank-you<\/code> and language file paths<\/li>\n<\/ul>\n\n<h4>1.2.1 - 2018-07-19<\/h4>\n\n<ul>\n<li>Tested with WooCommerce 3.4.3<\/li>\n<li>Tested with WordPress 4.9.7<\/li>\n<li>Moved the page option in WooCommerce &gt; Settings &gt; Advanced<\/li>\n<\/ul>\n\n<h4>1.2.0 - 2017-04-05<\/h4>\n\n<ul>\n<li>Compatibility test for WordPress 4.7.3<\/li>\n<li>Compatibility with WooCommerce 3.0<\/li>\n<li>Compatibility with WPML<\/li>\n<li>Dropped support for WooCommerce &lt; 3.0 - Update WooCommerce to<\/li>\n<\/ul>","raw_excerpt":"Replace the default WooCommerce Thank You page (order received page) with a custom Thank You page.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/eu.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/38201","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/eu.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/eu.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/eu.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=38201"}],"author":[{"embeddable":true,"href":"https:\/\/eu.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/riaanknoetze"}],"wp:attachment":[{"href":"https:\/\/eu.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=38201"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/eu.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=38201"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/eu.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=38201"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/eu.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=38201"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/eu.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=38201"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/eu.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=38201"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}