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.

  1. In the bundle editor, select + Add custom fields. This adds a group called "New custom fields" to the end of the bundle.
  2. Open the group's menu and select Settings to give it a title, such as "Personalise your gift".
  3. Select Add field to add a field to the group, then fill in its settings. See Field settings.
  4. 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:

  1. Open the parent group's menu and select Add custom fields. Or open the custom fields group's Settings and choose a Parent group.
  2. 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

TypeWhat customers seeExtra settings
TextA text boxCharacter limit and Multi-line
DropdownA list of options to choose from, starting at "Choose an option"Options: at least one, each with a label
Colour swatchesA row of colour circles, with the chosen colour's name beside the field's labelOptions: 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 0 for 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.

Previous
Condition groups