Skip to main content
BoxBuilder includes a built-in gift message feature. When enabled, customers can type a personal message that’s stored with the order and shown in confirmation emails.

​
Enable Gift Messages

Gift messages are controlled globally in BoxBuilder → Settings → Gift Message tab.
SettingDescriptionDefault
Enable Gift MessageShow the gift message field in the box builderEnabled
RequiredMake the gift message mandatory before adding to cartNo
LabelThe label shown above the text field”Gift Message”
PlaceholderPlaceholder text inside the field”Add a personal message…”
Max LengthMaximum number of characters allowed500

​
How It Works

  1. Customer sees a text field in the box builder (below the box summary)
  2. They type their personal message
  3. When the box is added to cart, the message is stored with the cart item
  4. At checkout, the message is saved as order item meta
  5. The message appears in:
    • Order confirmation page
    • Order confirmation email
    • Admin order screen (WooCommerce → Orders → Edit Order)
    • Customer’s My Account → Orders history

​
Customizing the Label

You can change the gift message label and placeholder text in BoxBuilder → Settings → Labels tab, or in the Gift Message tab for the specific label and placeholder.

​
Where the Message Appears

LocationVisible To
Cart pageCustomer
Checkout pageCustomer
Order confirmation pageCustomer
Order confirmation emailCustomer
Admin order screenStore admin
Packing slip (with compatible plugin)Warehouse staff
The gift message is stored as WooCommerce order item meta (_boxbuilder_message), so it’s accessible to any plugin that reads order item meta — including packing slip and PDF invoice plugins.

​
Developer: Accessing the Gift Message

// Get gift message from an order item
$message = $item->get_meta( '_boxbuilder_message' );

// Filter the gift message before saving
add_filter( 'boxbuilder/gift_message', function( $message, $box_id ) {
    // Modify or validate the message
    return $message;
}, 10, 2 );