# Gift Message Field on the Block Checkout

> Adds an optional "Gift message" field to the block-based checkout using the WooCommerce additional checkout fields API. The message is saved with the order and shown in the admin.

- Type: PHP
- Runs: Run everywhere
- Category: [WooCommerce](https://wpide.com/library/category/woocommerce/)
- Requires: WooCommerce
- Tags: woocommerce, checkout, blocks, gift
- Author: WPIDE Team
- Installs: 0
- Updated: 2026-10-28
- Page: https://wpide.com/library/woo-block-checkout-gift-message/

## Code

```php
add_action( 'woocommerce_init', function () {
    if ( ! function_exists( 'woocommerce_register_additional_checkout_field' ) ) {
        return;
    }

    woocommerce_register_additional_checkout_field( array(
        'id'                => 'wpide/gift-message',
        'label'             => 'Gift message (optional)',
        'optionalLabel'     => 'Gift message (optional)',
        'location'          => 'order',
        'type'              => 'text',
        'required'          => false,
        'sanitize_callback' => function ( $value ) {
            return mb_substr( sanitize_text_field( $value ), 0, 200 );
        },
    ) );
} );
```

## Notes

Needs WooCommerce 8.9 or newer and the Checkout block. For the classic checkout use a classic checkout field snippet instead.

## How to use it

Install the free WPIDE plugin (https://wordpress.org/plugins/wpide/), find "Gift Message Field on the Block Checkout" in its snippet library and add it in one click; or create a new PHP snippet in WPIDE (or any code snippets plugin) and paste the code above. More snippets: https://wpide.com/library/