SAKU Gift Option: How to set up extra fields such as ribbon color and gift message

You can add extra fields to the gift option, such as letting customers choose a "Ribbon color" or write a "Gift message". This article explains how to create, edit and reorder fields, and how they appear in your store.

In this article

• How to create a dropdown field (a list of choices)
• How to create a text field (free text) and set its maximum length
• How to edit, delete and reorder fields
• How fields appear in your store, and the error for text that is too long

Where to go: Shopify admin → Apps → SAKU Gift Option → "Gift Option Settings" → "Additional Info Settings"

What you need before you start

• SAKU Gift Option is installed
• Decide which fields you want to add (the field name, the field type, the options for a dropdown, or the maximum length for a text field)

1️⃣ Click "Add Field"

In the "Gift options" card of "Gift Option Settings", click "Add Field" at the right of "Additional Info Settings" to open the input dialog. Additional info belongs to each gift option. It appears right below the gift option, only when the customer chooses that gift option.

(The image shows an example after the "Ribbon color" and "Message card" fields have been added. The list is empty at first.)

The red boxes show the list of fields and the "Add Field" button in "Additional Info Settings".

2️⃣ Enter a field name and choose a type

Enter the "Field Name" (required). Customers see it as a heading. Then choose the "Field Type".

• "Dropdown" (default): use this when customers choose from options you set in advance, such as ribbon color or wrapping paper pattern.
• "Text Field": use this when customers type in text, such as a gift message.

Note: there is no setting to make a field required. Customers can continue without filling in a field.

3️⃣ Enter the dropdown options

In "Options (comma separated)", enter the choices separated by commas (,). For example: "Red, Blue, Gold".

• Options appear in your store in the order you enter them.
• Spaces before and after commas are removed automatically. Empty options are ignored.
• You can't save without at least one option ("Please add at least one option." appears).

4️⃣ Set the maximum length for a text field

When you choose "Text Field" as the field type, a "Max Length" field appears. The default is 100. A hint says "Set from 1 to 500 characters".

• Enter a whole number from 1 to 500. If it's outside this range, "Enter a whole number from 1 to 500" appears.
• Below the field, a capacity guideline is shown. When "Application Scope" is "Per product" and customers enter 100 Japanese characters in one message field per product, about 8 products with gifts can be added to the cart per order (this depends on the total data size, including field names and selected options). If there are several message fields, the characters in all of them are added together.
• If many of your orders put gifts on lots of products, it's safer to keep the maximum length short. For what happens when the limit is exceeded, see "How to set the input limit error message".

5️⃣ Save and check the list

Click "Save" in the dialog to add the field to the list (or "Cancel" to stop). In the list, a summary appears below each field name.

• Dropdown: the options are shown, for example "Dropdown: Red, Blue, Gold".
• Text: shown as "Text (max 100 chars)".

If the field name is empty, "Please enter a field name." appears and you can't save.

Finally, click "Save" in the save bar at the top of the screen to save all your settings.

[Example] Creating two fields

• First: Field Name "Ribbon color" / Field Type "Dropdown" / Options "Red, Blue, Gold" → "Save" in the dialog
• Second: Field Name "Message card" / Field Type "Text Field" / Max Length "100" → "Save" in the dialog
• Finally, click "Save" in the save bar at the top of the screen.

6️⃣ Edit, delete and reorder

• "Edit": the dialog opens with the heading "Edit Field", and you can change the field. Even if you change the options, existing translations of the options are carried over to match the original options.
• "Delete": removes the field. Its translations are also deleted automatically.
• Reorder: drag and drop the "⠿" handle at the left of a field (hovering over it shows "Drag to reorder"). When there are two or more fields, the hint "Drag and drop fields to reorder them. They appear in this order on your store." appears. Don't forget to click "Save" after reordering.

There is no limit in the admin on the number of fields. However, we recommend keeping it to 8 fields or fewer. From the 9th field on, fields may not appear correctly in the order details. On the Pro plan, the fields you add to the second and later gift options are limited to 8 in total across all gift options.

How it looks in your store

When a customer chooses anything other than "No thanks" for the gift, the extra fields appear. Dropdowns start with "Please select", and text fields show "Please enter" faintly in the box. The field name is used as the heading, and the order is the same as in the admin. If the choice stays at "No thanks", no extra fields appear.

If the text is longer than the maximum length, a red message appears below the field: "Please enter up to [max] characters (currently [count]). This cannot be added to the cart as is." (with the limit and the current number of characters filled in). Once the text is shortened, it can be added to the cart.

When added to the cart, the selected details are recorded in the cart and the order. To check them, see "How to check gift details in orders".

Troubleshooting

• The field can't be saved
  "Please enter a field name." means the field name is empty. "Please add at least one option." means the dropdown has no options. "Enter a whole number from 1 to 500" means the maximum length must be a whole number from 1 to 500.
• Extra fields don't appear in the store
  Extra fields appear only when a customer chooses something other than "No thanks" for the gift. Check that the gift dropdown isn't still set to "No thanks". Also check that you clicked "Save" in the admin and that the status is "Active".
• It can't be added because of a character limit error
  The text is longer than the maximum length. Shorten it. To change the limit, open the field with "Edit", change "Max Length", and save.
• The new order isn't applied
  Check that you clicked "Save" after dragging.