SAKU Gift Option: How to set a gift option for the entire order

This article explains how to offer the gift option "once for the whole order" instead of for each product. Customers choose the gift on the cart page.

If you haven't finished the basic setup yet, see "How to set up the app" first.

Overall flow

First, here is how the setup reaches your customers' carts.

1. In the app, set "Application Scope" to "Entire order" and set the status to "Active".
2. In the theme editor, open the cart page, add the "SAKU Gift (Cart)" block to the "Subtotal" section, and save.
3. (If needed) Turn on "Route customers through the cart page before checkout" and "Hide the Buy it now button", and enable the "SAKU Gift Cart redirect" app embed in your theme.
4. Customers choose one gift option for the whole order on the cart page. Customers who try to check out without choosing a gift are taken to the cart page (when the options are on).

To build this flow, you set it up in these steps.

1. Set "Application Scope" to "Entire order" and save
2. Add the block to the cart page
3. Set the two checkboxes
4. Enable the "SAKU Gift Cart redirect" app embed
5. Check your progress on the Home page

What you need before you start

• SAKU Gift Option is installed and you have already created a gift option (see "How to set up the app")
• A published theme whose cart page you can edit in the theme editor (to use "Route customers through the cart page before checkout", you also need the app embed in step 4)

In this article

• How to set "Application Scope" to "Entire order" and make it Active
• How to add the block to the cart page
• What "Route customers through the cart page before checkout" and "Hide the Buy it now button" do
• How to enable the "SAKU Gift Cart redirect" app embed
• What customers do on the cart page

Where to go: Shopify admin → Apps → SAKU Gift Option → "Gift Option Settings" → "Application Scope"

1️⃣ Set "Application Scope" to "Entire order" and save

① In "Application Scope" of "Gift Option Settings", choose "Entire order".
The "Application Scope" card has the choices "Per product" and "Entire order".

② Under "Status Settings" on the right, set "Status" to "Active".

③ Click "Save" in the save bar at the top of the screen.
After saving, the notice box "App block required on the cart page" and two checkboxes appear below "Application Scope".

The red box shows where you choose "Entire order" under "Application Scope", adding the block to the cart page, and the checkout redirect settings.

The block won't appear on the cart page until you save. When the scope is "Per product", the cart page block is hidden, and when it's "Entire order", the product page block is hidden.

2️⃣ Add the block to the cart page

① Click "Add block to cart page".
It is the button in the notice box "App block required on the cart page" below "Application Scope". The theme editor opens in a new tab with the "SAKU Gift (Cart)" block already added to the cart page (the block is added as a new app section in the cart template).

If the button doesn't open it, you can open the theme editor yourself and add the block: on the cart page, click "Add block" in the "Subtotal" section and choose "SAKU Gift (Cart)" from the "Apps" tab.

The red boxes show "Add block" in "Subtotal" and "SAKU Gift (Cart)" in the "Apps" tab.

② Decide where the block goes.
At first it may stretch across the full width and be hard to see. Drag and drop it to the position you like, for example above the checkout button. When you select the block, you can change its "Title" under "Block settings" on the right (the default is "Gift options").

③ Click "Save" at the top right.

The red boxes show "SAKU Gift (Cart)" added to the list on the left, the gift option in the cart preview, and "Save" at the top right.

3️⃣ Set the two checkboxes

Go back to "Gift Option Settings" in the app. When you choose "Entire order" under "Application Scope", two checkboxes appear below the "App block required on the cart page" notice box. They don't appear with "Per product". Both are off by default. Turn on only the ones you need (if you use neither, you can skip this step and step 4).

"Route customers through the cart page before checkout"

In themes such as Horizon, the cart opens as a "drawer" that slides in from the side of the screen, and customers can go straight to checkout from there. In that case, customers buy without seeing the gift option on the cart page. When this is on, customers who haven't chosen a gift option and click checkout are taken to the cart page.

• Customers who have already chosen a gift go straight to checkout.
• Clicking the checkout button on the cart page itself goes straight to checkout.
• This feature works when "Display name and price source" is set to "Set in the app".

"Hide the Buy it now button"

Instant checkout buttons such as Buy it now skip the cart and go straight to checkout. Customers then have no chance to add the order-wide gift, and nothing is written to the order note. When this is on, instant checkout buttons on product pages are hidden so customers buy through the cart. This also covers instant checkout buttons such as Shop Pay.

After changing the checkboxes, click "Save" in the save bar at the top of the screen.

4️⃣ Enable the "SAKU Gift Cart redirect" app embed

An app embed adds an app feature that works across the whole page, instead of being placed as a block. The two features in step 3 don't work unless this embed is enabled.

① Click "Enable checkout redirect in theme".
When you turn on either (or both) of the checkboxes in step 3, the note "These features work through the “SAKU Gift Cart redirect” app embed in your theme. Enable it with the button below." and the button "Enable checkout redirect in theme" appear. Click the button to open "App embeds" in the theme editor.

② Find "SAKU Gift Cart redirect" in the list and turn on its switch.
You can also open the same screen with the app embeds icon at the top left of the theme editor.

③ Click "Save" at the top right of the theme editor.
You're done when the "SAKU Gift Cart redirect" switch is on.

The red boxes show the app embeds icon at the top left and the "SAKU Gift Cart redirect" switch turned on.

This app embed also writes the gift details to the order note when there's a gift in the cart.

Note: if Home step 4, "Enable the app embed", appears on the app's Home page, you can open the same screen from there.

5️⃣ Check your progress on the Home page

When you go back to the app's Home page, Home step 3 changes to "3. Add the block to your cart page", and its badge becomes "Configured" once the block is in place. If Home step 4 (app embed) is needed, its badge also becomes "Configured". When everything is done, you'll see "Setup complete".

How it looks in your store (what customers do)

On the cart page, the "Gift options" block is shown already open. Customers choose one gift for the whole order here.

• Before choosing a gift: a dropdown (default "No thanks"), the extra fields and the "Add gift option" button are shown. The button can't be clicked until a gift is chosen.
• After adding: the chosen gift's display name, price and extra field values are shown, and the button changes to "Remove gift option".
• The order-wide gift is fixed at a quantity of 1. Even if the customer increases the quantity of items or removes items, the gift stays at 1.

To see how it's recorded in orders, see "How to check gift details in orders".

Troubleshooting

• The block doesn't appear on the cart page
  Check that (1) the scope is saved as "Entire order", (2) the status is "Active", and (3) you added "SAKU Gift (Cart)" to the cart page in the theme editor and clicked "Save".
• My cart is a drawer and I can't see the block
  The block appears only on the cart page. Open the cart page with "View cart" in the drawer to see it. For customers who check out straight from the drawer, turn on "Route customers through the cart page before checkout" and enable the app embed.
• Orders placed with Buy it now have no gift
  Turn on "Hide the Buy it now button", enable the "SAKU Gift Cart redirect" app embed, and save the theme.
• Clicking checkout doesn't go to the cart page
  Check that the app embed is on and the theme is saved. If a gift is already in the cart, customers go ahead without being redirected. This only works with the "Set in the app" method. If the check takes too long or fails, customers go ahead so their purchase isn't blocked.
• It stopped redirecting after I switched to "Use product information"
  "Route customers through the cart page before checkout" works only with the "Set in the app" method. Hiding "Buy it now" works with either method.