Creating bundles
Custom fields
Custom fields let customers tell you something about their bundle, such as a gift card message, a name to engrave or a ribbon colour. Their answers are added to the bundle in the cart and appear on the order, so you have them when you fulfil it.
Custom fields don't change the bundle's price or contents.
Add a custom fields group
Custom fields sit in their own group, which appears as a section of the bundle form like any other group.
- In the bundle editor, select + Add custom fields. This adds a group called "New custom fields" to the end of the bundle.
- Open the group's menu and select Settings to give it a title, such as "Personalise your gift".
- Select Add field to add a field to the group, then fill in its settings. See Field settings.
- Add more fields if you need them, then save the bundle.
A custom fields group can hold several fields. Drag a field by its handle to change the order customers see them in.
Show fields only for some choices
A custom fields group can be nested under another group, so its fields only appear once the customer makes a choice there. For example, show an "Engraving text" field only when the customer chooses an engravable flask:
- Open the parent group's menu and select Add custom fields. Or open the custom fields group's Settings and choose a Parent group.
- To show the fields for one product only, set Only show when this product is selected to that product.
Fields in a hidden group aren't required and aren't added to the cart. See Nested groups.
Custom fields groups can't be parents themselves. Other groups can't be shown based on a customer's answer to a field.
Field settings
Label
The field's name on the bundle form, for example "Name on wish card". Required.
Cart property name
The name shown next to the customer's answer in the cart, at checkout and on the order. It follows the Label until you change it.
Each field in a bundle needs a different cart property name. Names can't start with _bundlem8, because BundleM8 uses that prefix for its own data.
Help text
Optional guidance shown with the field, for example "Enter 'NA' if you don't need a card". Up to 500 characters.
Field type
| Type | What customers see | Extra settings |
|---|---|---|
| Text | A text box | Character limit and Multi-line |
| Dropdown | A list of options to choose from, starting at "Choose an option" | Options: at least one, each with a label |
| Colour swatches | A row of colour circles, with the chosen colour's name beside the field's label | Options: at least one, each with a label and a colour |
For text fields:
- Character limit: the most characters the customer can enter. Leave it empty or set it to
0for no limit. When there's a limit, the form shows how many characters are left. - Multi-line: a larger text box for longer messages.
For colour swatches, enter each colour as a hex value, such as #ffffff. The label is what appears on the order, for example "White".
Optional
Off by default, so customers must fill in the field before they can add the bundle to the cart. If they don't, the group shows "Please fill in the required fields."
Turn Optional on to let customers skip the field. The form marks optional fields with "(optional)".
Customers' answers in the cart and orders
Each answered field is added to the bundle's cart item as a line item property, using the Cart property name. For example:
Name on wish card: Happy birthday, Sam!
Most themes show line item properties in the cart. The answers also appear at checkout and on the order in your Shopify admin, alongside the bundle. Fields the customer left empty aren't added.
Changing a field after customers have ordered
Changing a field's cart property name doesn't change orders that have already been placed. Bundles already in customers' carts keep the property name they were added with.
Check your fields
The bundle editor checks custom fields groups when you save. A custom fields group needs a title and at least one field, or you'll see "Group must contain at least one field."
Use Preview form in the bundle editor to see how the fields look before saving.
