--- title: "Gift Notes" description: "Let customers add or update gift-note fields and choose where each value is stored on the Shopify order." url: https://docs.orderediting.com/en/articles/14154654-gift-notes collection: "App Blocks" updated: 2026-08-20 language: en --- # Gift Notes Let customers add or update gift-note fields and choose where each value is stored on the Shopify order. Set up **Gift Notes** when customers should be able to add or correct a sender name, recipient name, or gift message after checkout. Each visible field must be connected to an order attribute, an order metafield, or a property inside a JSON order metafield. # Before you begin - Ask your fulfilment team where it currently reads gift-note data. - If another app already creates gift notes, reuse the same field references so an edit updates the existing data. - Create any required Shopify order metafield definitions before configuring the fields. # Enable gift-note editing 1. In Order Editing, open **App Settings**. 2. Select **Editing blocks**. 3. Open **Gift Notes and Personalization**. 4. In **Gift Notes**, choose **Let customers save gift notes on the order**. 5. Select **Add gift note fields**. If gift-note fields are already configured, the action is **Edit gift note fields**. # Configure the fields The editor contains **From**, **To**, and **Message**. A field is hidden from customers when its required reference is blank, so you only need to configure the fields your store uses. For each field: 1. Choose a **Source**. 2. Enter the required reference. 3. For a JSON metafield, enter the **JSON property** that contains the value. 4. For **Message**, optionally enter a positive **Character limit**. Leave it blank when you do not need an explicit limit. 5. Select **Save**.

Source	Reference format	Use it when
Order attribute	Exact attribute key, such as `_gift_message`	Your checkout, theme, or fulfilment workflow uses Shopify order attributes.
Order metafield	`namespace.key`, such as `custom.gift_message`	Each gift-note value has its own structured order metafield.
JSON metafield	`namespace.key` plus a JSON property	Several gift-note values are stored inside one JSON order metafield.

The metafield reference must contain both a namespace and key. A JSON metafield also requires a property; otherwise that field is not saved. # Start with standard attribute fields Select **Use standard attribute fields** to prefill the following configuration:

Gift-note field	Order attribute
From	`_gift_from`
To	`_gift_to`
Message	`_gift_message`

The standard setup also starts the message with a 250-character limit. Review these keys before saving: using them helps only when your fulfilment workflow reads the same attributes. If standard fields were already applied, the action becomes **Reset to default fields**. Resetting replaces the field draft in the editor; review it before selecting **Save**. # What the customer experiences During the editing window, the customer sees each configured gift-note field and its current value. When they save an edit, Order Editing writes the new value to the source you selected on the Shopify order. The app does not print a gift card or instruct the fulfilment team by itself. Your warehouse, theme, or connected app must read the configured value and use it in the fulfilment process. # Check the setup 1. Find an existing eligible order with the same gift-note data your normal checkout uses. 2. Open the order while it is editable. 3. Confirm only the configured **From**, **To**, and **Message** fields appear. 4. Change each visible value and save the edit. 5. Open the Shopify order and confirm the correct attribute, metafield, or JSON property was updated. 6. Confirm the updated value reaches the fulfilment view or connected app used by your team. # If a value is not saved - Confirm an order-attribute key exactly matches the key used on the order. - For an order metafield, use `namespace.key` and confirm its definition exists on orders. - For a JSON metafield, confirm both the metafield reference and JSON property are present. - If the message limit is set, enter a positive whole number. - Confirm gift-note editing is enabled and the order is still editable. ## Related - [Setting Up Checkout Line Item Editing](https://docs.orderediting.com/en/articles/15311167-setting-up-checkout-line-item-editing.md) - [Shipping Address Edits](https://docs.orderediting.com/en/articles/14154099-shipping-address-edits.md) - [Change Products](https://docs.orderediting.com/en/articles/14154149-change-products.md) - [Quantity Edits](https://docs.orderediting.com/en/articles/14154273-quantity-edits.md) - [Product Search](https://docs.orderediting.com/en/articles/14154310-product-search.md)