SAKU Gift Option: What to check when the option doesn't show or can't be added

Easy setup
Simple
$4.99/mo

App features

Easy to set up, with no unnecessary features
Easy to start at $4.99/mo
Fully supports Japanese
Simple, with nothing you don't need
A clean, refined UI that doesn't get in the way of your design
Add a paid or free option.
Add extra fields: a selection (dropdown) or text.

October 14, 2026

Here's what to check when something goes wrong, for example "the gift option doesn't appear", "it can't be added to the cart" or "I can't save". Work through the checks from the top.

What you need before you start

SAKU Gift Option is installed
On a live store, your paid plan is active (if you cancel, the block isn't shown)

In this article

What to check when the gift doesn't appear on product pages or the cart page
What to check when it can't be added to the cart
What to check when the gift isn't in the order note
What save error messages mean
What to do when "Run Initial Setup" appears
How to use the in-app Help

1️⃣ The gift option doesn't appear

Check the following in order. Items 1, 2, 4 and 5 are checked in the app's admin screen, item 3 in the theme editor, and item 7 on your plan screen. If you fix something in the app, click "Save".

On the right side of the app's "Gift Option Settings", is the badge green and set to "Active" (and did you click "Save" after changing it)?
Is the "Application Scope" right? With "Per product", it appears only on product pages; with "Entire order", only on the cart page.

The red box shows "Application Scope" and the note about the block you need.
Did you add "SAKU Gift (Product page)" or "SAKU Gift (Cart)" in the theme editor and click "Save" at the top right?

The red box shows the "SAKU Gift" block to select and place.
Did you select a product in "Gift option 1" of the "Gift options" card?
Is "Run Initial Setup" shown at the top of the app?
With the "Use product information" method, did you enable the app embed and save the theme, and publish the gift product to the Online Store and the markets where you sell?

The red box shows the app embed to turn on, then save.
On a live store, is your paid plan active (if you cancel, the block isn't shown)?

In themes with a cart drawer (a cart that slides in from the side of the screen), the order-wide block appears only on the cart page. Open it with "View cart" in the drawer.

If you separate products without gifts, also check that the product's template has the block (see "How to hide the option on specific products").

2️⃣ The gift can't be added to the cart

Check that inventory tracking is turned off for the gift option product. If inventory is tracked, it can't be added when it's out of stock.
Check where the gift product is published (Online Store) and the markets it's sold in.
If "Run Initial Setup" appears at the top of the app, click the button.
If your settings need the "SAKU Gift Cart redirect" app embed, enable it and save the theme.
If you deleted the product or changed its URL handle, select the product again in "Gift Option Settings" and save.
Per-product gifts with the "Use product information" method don't support product forms with subscriptions or file uploads.
If you use custom add-to-cart code or a third-party cart app, test it before going live. Contact support for help with compatibility.

3️⃣ The gift isn't in the order note / Buy it now orders have no gift

The order note is written through the cart. It may be missing for purchases that skip the cart (such as Buy it now).
For order-wide gifts, to remove the instant checkout route, turn on "Hide the Buy it now button", enable the app embed, and save the theme. If customers check out straight from the drawer, also turn on "Route customers through the cart page before checkout" (see "How to set a gift option for the entire order").
When shipping, check the line items as well as the note (see "How to check gift details in orders").

4️⃣ Settings can't be saved (what the error messages mean)

When settings can't be saved, a message appears in a red banner or toast at the top of the app screen. Find the message you see in the table below and follow the "What to do" in the same row.

Note: "reload" means clicking your browser's reload button (or pressing Ctrl+R on Windows or ⌘+R on Mac).

Message	What to do
The settings format is invalid. Reload this page and enter your settings again.	Reload the page and enter your settings again.
Enter a non-negative price with the correct decimal precision for your store currency.	Use numbers only, 0 or more, with no more decimal places than your store currency allows (no decimals for yen). This is checked only with the "Set in the app" method.
The wrapping product was not found. Select the product again.	Check that the gift option product hasn't been deleted, then select it again with "Change Product".
Your store currency changed. Reload and review the prices before saving.	Reload and re-enter the prices in the new currency. If a yellow banner says "These prices were saved in [currency]. …", follow its instructions.
These settings were updated elsewhere. Copy your changes, reload, review the latest settings, and save again.	Someone saved first in another tab or from another account. Note down your changes, reload, review, and save again.
The access required to save settings is unavailable. Update the app permissions and try again.	Check whether the app is asking you to update its permissions, and approve them.
Shopify is receiving too many requests. Wait a moment and save again.	Wait a moment and save again.
Gift settings and translations exceed Shopify’s 10,000-byte limit. Reduce the fields, text or gift options and save again. Your changes were not saved.	Reduce the fields or translated text and save again.
Could not save your settings. Check your input and try again shortly.	Check your input, wait a moment, and try again.
Missing required data to save.	Reload the page and enter your settings again.
Please select a variant.	For a product with several variants, choose one variant.
Please enter a field name. / Please add at least one option. / Enter a whole number from 1 to 500	Correct the field's settings (see "How to set up extra fields such as ribbon color and gift message").
Enter an input limit error message of no more than 200 characters.	Shorten it to 200 characters or fewer.

If more than one gift setting has been saved, a yellow banner says "There are 2 or more entries. Only the first one is displayed and editable." In that case, only the first one can be shown and edited on the page. If you have any questions, contact us at info@saku-apps.com.

5️⃣ "Run Initial Setup" appears

If "Cart Transform is not configured. Please run the initial setup to enable app features." appears at the top of the app, the initial setup that applies gift prices in the cart hasn't finished yet. Click "Run Initial Setup" once ("Setting up..." appears while it runs).

Success: "Initial setup is complete." or "Initial setup is already complete." (green)
Failure: "Initial setup could not be completed. Please try again later. If the issue continues, contact support." or "The function needed for initial setup is unavailable. Please contact support." (red)

6️⃣ Use the in-app "Help"

Open "Help" in the app's left menu to see the page headed "Help / Frequently asked questions". You can view illustrated setup instructions from "Open the setup guide" on the page. It covers the following.

"Setup guide and support": the "Open the setup guide" link to the "Setup guide with images", and the support email address.
"Getting started (4 steps)": creating the product, configuring the gift, adding the block to your theme ("Open theme editor (product template)" and "Open theme editor (cart page)"), and checking it in your store.
FAQ: "Gift settings (product, name and price)", "Additional fields (ribbon color, gift message and more)", "Translations", "Scope (per product or per order)", "Publication status", "Adding the block to product pages", "Customer experience (storefront)" (which also covers how gifts look in the cart, quantity syncing, and what to do when a gift can't be added) and "Pricing and plans".

7️⃣ Other checks

Home step 3 is unverified: the app can't get the status of your theme. The guide for Home step 3 stays visible. Add the block in the theme editor, save, and reopen the Home page.
You changed your store's base currency: re-enter the prices and save (see the table above).
The gift product can't be purchased and the choice is disabled: with the "Use product information" method, the gift product can't be purchased (out of stock, unpublished and so on).
You want to remove the "More apps" section from Home: hide it with the "×" at the top right (it can't be shown again).
You're taken to Shopify's pricing page: see "How to check and change your plan".
How to check gifts in orders: see "How to check gift details in orders".