Getting started with ThankBuilder

Which pages can show blocks?

Blocks can appear in four places: the Thank you page, the order status page, and the order list and profile pages of customer accounts (My Page). Which places you can use depends on your plan.

The Thank you page is the page shown right after a purchase to thank the customer for their order. The order status page is where customers check shipping status, opened from places like the link in the order confirmation email. Customer accounts (My Page) are the pages where logged-in customers view their order history and profile. To show blocks on the order status page and My Page, your store must use Shopify's new customer accounts. The app's screens also show a notice that new customer accounts are required.

You choose which page shows blocks by placing the app block in each page's editor, not in the block edit screen.

How do I show my first block?

The content you create in the app's admin is called a "block", and the container you place in the editor is called an "app block". One app block shows the blocks you created, lined up inside it. The app dashboard shows three steps: 「①ブロックを作成して保存 ②エディタに配置 ③エディタで保存」 (1. Create and save a block, 2. Place it in the editor, 3. Save in the editor). The steps on this page follow the same flow.

1. Check your customer accounts typeIf you also want to show blocks on the order status page or My Page, go to Settings > Customer accounts in the Shopify admin and check that you use new customer accounts. If you only show blocks on the Thank you page, you can skip this check.
2. Open ThankBuilderOpen it from the app list in the Shopify admin. In the admin, it appears as "Thank You Account Builder".
3. Add a blockClick 「＋ ブロックを追加」 (+ Add block) and choose a template or 「空のブロック」 (Empty block). For an empty block, you choose the type, such as text or image, in the edit screen.
4. Set the content and saveSet what to display and, if needed, display conditions, then click 「保存する」 (Save). Saved content goes live on your store right away; there is no "publish" step. Each block automatically gets a code such as B1 or B2.
5. Place the app block in the editorPlace the Thank you page block in the checkout editor, and the order status page and My Page blocks in the customer accounts editor. To open the checkout editor, click Settings at the bottom of the left menu in the Shopify admin, open Checkout, and click Customize. To open the customer accounts editor, go to Settings > Customer accounts and click Customize. Checkout and customer accounts share the same editor, so whichever way you open it, you can switch between the Thank you page, order status page, and My Page with the page selector at the top of the editor. You can also open it from buttons on the app dashboard and the block list. The checkout editor first opens on the checkout page, so switch to "Thank you" with the page selector at the top. Then choose Apps from Add section on the left, and add the app block with the following name to the page where you want blocks to appear.Thank you page (the "Thank you" page in the checkout editor): Thank You Account BuilderOrder status page (customer accounts editor): 「Thank You Account Builder (注文状況)」 (Order status)My Page order list and profile (customer accounts editor): 「Thank You Account Builder (マイページ)」 (My Page)
6. Choose which blocks to showIn the placed app block's 「表示するブロック」 (Blocks to show) setting, enter the codes of the blocks you want to show, separated by commas (for example: B1,B3). They appear in the order you write them. If you leave it blank, all blocks appear in the order of the admin list. Then click Save in the top right of the editor. This is separate from 「保存する」 (Save) in the app's admin.
7. Check the displayPlace a test order and check the content, order, and links on the Thank you page. You can also check it in the checkout editor preview. For My Page, log in to your store as a test customer and check it.

What should I check before blocks go live?

• Images and text are easy to read on smartphones too
• Coupon codes and link destinations are correct
• Display conditions don't include orders or customers you don't want to target
• The pages and features are available on your current plan

Common stumbling points for first-time users

The app block doesn't appear in the editor

Check that "Thank you" is selected in the page selector at the top of the checkout editor. The editor first opens on the checkout page. The app blocks for the order status page and My Page only appear in the customer accounts editor if you use new customer accounts.

I saved in the app, but nothing shows on the page

After placing the app block, check that you clicked Save in the top right of the editor. Clicking 「保存する」 (Save) in the app's admin alone doesn't save changes in the editor.

I reordered blocks, but the display order didn't change

If you entered codes in the app block's 「表示するブロック」 (Blocks to show), the order you wrote takes priority. The admin list order is only used when 「表示するブロック」 is blank.

Custom HTML shows the name as {{first_name}}

Text variables don't work in custom HTML blocks. To insert a name, use a text block.

I saved a block, but it doesn't show on the page

Creating a block alone doesn't display it. Place the "Thank You Account Builder" app block in the checkout editor (Thank you page) or the customer accounts editor (order status page and My Page). For the order status page, use 「Thank You Account Builder (注文状況)」 (Order status); for My Page, use 「Thank You Account Builder (マイページ)」 (My Page).

A block whose code I entered in 「表示するブロック」 doesn't appear

Codes that don't exist are ignored without any warning. To avoid typos, click 「すべてのコードをコピー」 (Copy all codes) on the 「ブロック」 (Blocks) screen in the left menu (the block list) to copy them all at once, paste them in the editor, and delete the codes you don't need.

Saving or deleting is visible to customers right away

There is no "publish" button. Saving, deleting, and reordering blocks go live on your store right away. Deleting can't be undone. To hide a block temporarily, remove its code from 「表示するブロック」 (Blocks to show) in the editor.

Blocks don't show on the order status page or customer accounts

The Free plan covers the Thank you page only. Even if you place the app block on other pages, blocks won't appear there on the Free plan.

The third block doesn't show on the Free plan

On the Free plan, up to 2 blocks can be displayed. You can still create a third block and more, but the third and later blocks in display order are marked 「プラン制限で非表示」 (Hidden by plan limit) in the block list and are not displayed. The block list also shows the notice 「Free プランで表示できるのは2ブロックまで。3つ目以降は非表示です」 (The Free plan can display up to 2 blocks. The third and later blocks are hidden). To display the third block and beyond, switch to the Basic plan or higher.

A block for first-time buyers doesn't appear

The order count is the number of past orders, not including the current one, so a first-time buyer has 0. For the order count condition, choose 「初回のみ（過去0回）」 (First order only, 0 past orders). For guest checkouts, the order count and customer tags can't be checked, so the block follows the 「ゲスト購入（顧客情報がない場合）の扱い」 (Guest checkout handling, when there is no customer info) setting, and by default it is not shown. To show it for guest checkouts too, choose 「表示する」 (Show).

Variables like the name show the fallback text instead

Text variables are a Pro plan feature. On the Free and Basic plans, variables are not replaced. Right after switching to the Pro plan, run 「既存顧客の同期（バックフィル）」 (Sync existing customers, backfill) on the 「変数設定」 (Variable settings) screen.

For other symptoms, see "When ThankBuilder blocks don't appear".