SAKU Gift Option: How to check gift details in orders

This article explains how to check the gift a customer chose in the Shopify order after purchase, so you know where to look when packing and shipping.

In this article

• How to check gift details in the order's line items
• What is written to the order note
• How orders differ depending on the scope and the price method
• How gifts look in the cart, and what to watch out for

Where to go: Shopify admin → Orders → the order

What you need before you start

• SAKU Gift Option is installed and the gift option is shown in your store
• At least one order has been placed with a gift (a test order works too)

1️⃣ Open the order

Under "Orders" in your Shopify admin, open an order with a gift. There are two places to check: the order's "line items" and the "Notes" box.

The list of products at the top of the order details page (one row per purchased item) is the line items. The note is shown in the "Notes" box.

Note: the layout of the order details page in the Shopify admin (names and positions) may change with Shopify updates.

When shipping, check the line items as well as the order note. The order note is written through the cart, so it may be empty for purchases that skip the cart (such as Buy it now).

2️⃣ Check the line items

The order's line items show the following (extra information for each item, called "line item properties" in Shopify).

• The display name of the chosen gift, for example "Gift option: Gift wrapping"
• "Field name: chosen value (or entered text)", for example "Ribbon color: Red" and "Message card: Happy birthday"

Field names and display names are recorded in the language the customer was using. Text the customer entered is recorded as is.

The image above is an example of an order with "Per product" and "Set in the app". It is split into two rows, the purchased item (Drip coffee gift) and the gift wrapping, and both contain the same details. The two rows are shown together as one set under a "Group name".

• "Gift Wrapping ID: No.1": a number for each item–gift pair. It's used to tell rows apart when different gifts are added to the same product. This field is always recorded in English, whatever the language.
• "_gift_uid" and "_gift_component": fields the app uses internally. Fields starting with "_" aren't shown in the customer's cart or checkout, but Shopify shows them on the order details page in the admin. Don't delete or change them; just leave them as they are.

You've found the gift details when rows such as "Gift option" and "Ribbon color" appear in the line items.

[Pro plan] When you add several gift options

• For each gift option, the field name and the selected gift's display name are listed, such as "Gift option: Message card" and "Wrapping: Gift wrapping". The first field name is "Gift option"; the second and later field names are the headings you entered in the admin (for example, "Wrapping").
• If you left the heading of the second or later gift option blank, its field name is a number, such as "Gift option 2" or "Gift option 3" (customers in English see "Gift option 2").
• Additional info (such as "Card color: Red") is recorded only for the gift options the customer chose. Additional info of a gift option set to "No thanks" is not recorded.

3️⃣ Check the order note

The details synced in the cart are also recorded together in the order's "Notes". The heading and format depend on the country of your store's address.

• The heading stays the same even if the customer changes the display language.
• For stores in Japan, gift names, field names and options in the note are recorded in the original text set in the app (with "Use product information", the gift name is the registered product name). Line item fields are recorded in the customer's display language.
• If the note would be longer than 5,000 characters, only long entries are shortened, and "• * Long entries are shortened here (full text in the order line items)" is added (on stores in Japan, the Japanese equivalent is added). Check the full text in the line items.
• Notes written by customers or other apps are kept, and only the gift part is replaced.

Even if your store uses Japanese, the heading is "[Gift option]" when the store address registered under "Settings" → "Store details" in Shopify is outside Japan. If you want the Japanese heading "【ギフトオプション】", check your store address country.

You've found the note when the "Notes" box contains the gift details starting with the heading (the Japanese heading or "[Gift option]").

4️⃣ How orders differ by setting

In short: with any setting, you can tell what to pack by looking at rows such as "Gift option" and "Ribbon color" in the order's line items. The table below is extra detail for those who want it.

Clicking the set's details link on the order page takes you to "Gift Option Settings" in the app.

Note: the gift item is named after the product: at checkout and in the order's line items, the gift item is shown with the product name of the product you registered for the gift, not the display name set in the app (if the product has variants, the variant name is shown too). With "Set in the app", the app's display name is recorded in the "Gift option: display name" detail. To change the item name, edit the gift product's name (or variant name) under Products in Shopify admin.

5️⃣ Know how gifts look in the cart

Per-product gifts appear in the cart as an option attached to the purchased item. How it looks depends on your theme. If the customer changes the quantity of the purchased item, the gift changes to the same quantity, and if the item is removed, the gift is removed too.

The red box shows the gift contents in the cart. The chosen gift options and additional info are listed below the product, and the prices of the gift options are added to the product price.

With the "Use product information" method and a theme with a cart drawer, the customer is taken to the cart page after adding the gift. If the purchased item and the gift can't be combined into one product group, adding is stopped and an error is shown.

Other information

Your gift settings are stored in the app's own storage. They aren't shown on other merchant-facing pages.

Troubleshooting

• The gift isn't in the order note
  The order note is written through the cart, so it may be missing for purchases that skip the cart (such as Buy it now). If you use the "Use product information" method, or "Route customers through the cart page before checkout" or "Hide the Buy it now button" for an entire order, check that you enabled the "SAKU Gift Cart redirect" app embed and saved the theme. When shipping, also check the line items.
• The line items have unfamiliar fields such as "_gift_uid" and "Gift Wrapping ID"
  These are fields the app uses to tell rows apart. Fields starting with "_" aren't shown to customers. Shopify shows them in the admin, but please leave them as they are.
• The order note heading is "[Gift option]"
  Your store address country is set to a country other than Japan. Check the address country under "Settings" → "Store details" in Shopify.
• Part of the note is shortened
  When the note would exceed 5,000 characters, long entries are shortened. The full text is in the line items.