This guide shows how to sell a paid gift message inside your bundle. You add an optional "Add a gift card" step that contains a single paid product, then attach a custom field group that only appears when the customer selects that product. Customers who want a gift message add the card (and pay your fee) and fill in the message; everyone else skips the step and sees nothing extra.
It builds on the Custom Fields feature. Showing fields "On specific selection" is conditional visibility, which is an Advanced plan feature, so you will need the Advanced plan to follow this guide.
ℹ New to custom fields? Read Custom Fields first for the full reference on groups, fields, and settings.
Due to the way Shopify allocates the discount across all items inside a bundle, the gift card itself will also be discounted as it is inside the bundle.
Read more about how prices work inside of bundles
A bundle in the Biscuits Bundles app (or create a new one).
A "gift card" product in Shopify, priced at the amount you want to charge for the gift message. This can be any normal product - it does not have to be a Shopify gift card.
The Advanced plan, for conditional "On specific selection" fields.
The paid product and the gift message fields live in the same step. Selecting the product does two things at once: it adds the product's price to the bundle total (your extra charge), and it reveals the gift message fields, because the group is set to show only when that product is selected. Conditional visibility only reacts to selections in the same step, which is why the product and the fields belong together.
In Shopify, create a product to represent the gift message - for example "Gift card" or "Add a gift message".
Set its price to the amount you want to charge (for example 5.00).
Save the product. It only needs to exist so your bundle can sell it.
Tip: if you do not want this product browsable on its own, see GUIDE: How to hide bundle component products on your store.
Open your bundle and add a new step.
Give it a clear Title, such as "Add a gift card".
In the step's Details section, untick "Required step" so customers can skip it. The step will show an "Optional" badge.
In the step's Rules, set the Minimum to 0 so it can be left empty. If you only want one gift card, set the Maximum to 1.
Add your gift card product to this step's Products.
In the builder sidebar, click the small arrow (chevron) next to the Add step button and choose "Add a custom field group".
Drag the new group so it sits below the "Add a gift card" step's products, so the fields appear under the gift card.
Click "Auto set up gift message fields" to instantly add From, To, and Message fields and set the group title. You can also add or edit fields manually.
With the group selected, open the Conditions (Group visibility) section.
Choose "On specific selection".
Pick your gift card product (or its variant) as the trigger. The fields now stay hidden until the customer selects that product.
ℹ If "On specific selection" shows a lock icon, it is not included on your current plan. Upgrade to the Advanced plan to use conditional fields, or set the group to "Always show" so the fields appear for everyone.
In the group settings, set "Attach line item properties to". If the gift card is the only product in this step, either option works - the message is saved on the gift card line item. Choose "First selected" to keep it on a single product.
If you want a customer who adds the gift card to be required to write a message, turn on "Required" for the Message field. Because the fields are hidden until the gift card is selected, this requirement only applies to customers who actually add the card - everyone else can still check out.
Save your bundle.
On your storefront, open the bundle and confirm the "Add a gift card" step can be skipped, and that the gift message fields are hidden until you select the gift card.
Select the gift card, fill in the message, and add the bundle to cart. Check that the price increased by your fee, and that the message shows in the order's line item properties after checkout.
ℹ We always recommend placing a test order to confirm everything works the way you expect.
Your gift card is a real product with its own price, so selecting it adds that price to the bundle. How much extra the customer pays depends on your bundle's Discount type:
Sum of Products - the full gift card price is added. Best choice for a predictable add-on fee.
Percentage or Amount discount - the gift card price is added to the items total, then your bundle discount is applied, so the fee is discounted too.
Fixed Total Price - the whole bundle is one flat price, so adding the gift card will not increase what the customer pays. Avoid this type if you want the gift card to charge extra.
Volume discounts - the gift card counts as another item, which can change which tier the customer lands on.
The fields don't appear when I select the gift card
Make sure the custom field group is attached to the same step as the gift card, and that the trigger matches what the customer can actually pick (product vs variant). Conditional visibility only reacts to selections within the same step.
"On specific selection" is locked
Conditional visibility is an Advanced plan feature. Upgrade to use it, or set the group to "Always show".
The gift card didn't add any cost
Check your bundle's Discount type. A Fixed Total Price bundle charges one flat price, so optional add-ons will not increase it. Use Sum of Products (or a percentage or amount discount) instead.
The message is on the wrong product
Check the group's "Attach line item properties to" setting. "All selected" puts the answer on every product picked in the step; "First selected" puts it only on the first.
I just want to collect a message without charging
Skip the product and use a plain custom field group set to "Always show". See Custom Fields and its Quick Setup: Gift Message.
GUIDE: Adding a gift message to your bundle product (the older code-based method)
