# Gift messages

Print the gift message your customer typed on the gift slip, word for word.

import DocUpdated from '~/components/DocUpdated.astro';

> **Floormode prints the gift message your customer typed, word for word, on the gift slip.**
> It reads it from an order field you name. It never guesses it from the order note.

Shopify keeps the fields a cart or a gift app adds to an order as **Additional details** on
the order page. Floormode reads them as they are, finds the gift message, who it is for and
who it is from, and prints them on the gift slip. Nothing is sent anywhere: no AI, no other
service.

## On this page

- 1. Add a gift-message field to your theme
- 2. Map the field
- 3. What prints
- What changed with gift fields
- For developers
- See also

## 1. Add a gift-message field to your theme

Skip this step if a gift app (Giftship, Giftnote) or a checkout field already collects the
message.

In Dawn and most themes, open **Online Store → Themes → Edit code**, then
`sections/main-cart-footer.liquid`, and add this inside the cart footer:

```liquid
<label for="gift-message">Gift message</label>
<textarea id="gift-message" name="attributes[Gift message]" form="cart"></textarea>

<label>
  <input type="checkbox" name="attributes[Gift]" value="Yes" form="cart">
  This is a gift
</label>
```

- `attributes[Gift message]` becomes the order's **Gift message** field.
- The checkbox is optional. It marks a gift without a message.
- A name that starts with `__` (`attributes[__Gift message]`) is private: the customer does
  not see it at checkout, and Floormode still reads it.

**Shopify Plus:** a Checkout Blocks custom field set to *Save as order attribute* works the
same way. Fields added in checkout cannot be filled in an Apple Pay or Google Pay express
checkout, so keep the cart field too.

## 2. Map the field

Open **Settings → Packing → Packing slip** (in the Advanced section) and press
**Edit gift fields**.

1. **Add a field.** Pick its name from the list: it shows the field names on your newest
   1,000 orders first, then the common gift fields. Or type a name no order has yet.
2. **Holds:** *Gift message*, *To*, *From*, or *Marks a gift*.
3. **Stores** (with two stores or more): read it on some stores only. Empty means every store.
4. Press **Done**, then **Save** in the page's bar.

Case and separators do not matter: `Gift Note`, `gift_note` and `gift-note` are one field.
Up to 10 fields. The first field in the list that holds words wins.

Under each saved field the card says what your newest orders show: *On 7 recent orders*,
*Not on your newest 1,000 orders* (check the name in Shopify under Additional details), or
*A common gift field*.

**Also read the common gift fields** (on by default) reads these names without mapping them:
Gift message, Gift note, Gift notes, giftnote_message, giftnote_to, giftnote_from, gift,
is_gift, gift-wrap, gift-wrapping, gift-wrapped. Turn it off to read only your fields.

## 3. What prints

| The order | The slip's title | What it prints of the gift | The order note |
|---|---|---|---|
| no gift, or **Gift slips** off | Packing slip (label: Delivery note) | nothing | printed |
| a gift message | Gift slip | To, the message, From | not printed |
| a gift without a message (marked, or To / From only) | Gift slip | To and From | see below |

**Order note on a gift slip** decides the last row: *Only when the gift has no message*
(the default: the card text may be in the note) or *Never*. It works with the common fields
alone, so `Gift: Yes` with *Never* prints no note.

The packer always sees the whole message, where it came from and what will print, at the
pack station before printing. The order page shows the same line.

**Limits.** The A4 / Letter slip prints up to 6 lines of the message and one line each for
To and From. The label-size delivery note prints up to 2 lines per section. A longer text
ends in "…". Line breaks are kept. Letters the standard font lacks (Cyrillic, Greek) print in
the label font; a character no font has prints as `?`.

A field longer than 500 characters, or past an order's 50th field, cannot be kept by
Floormode. If it is a gift message, the order still counts as a gift and the pack station
says *A gift field was too long or too many to keep: see the order in Shopify*.

A slip printed before you change a setting is not changed: reprinting a stored slip prints
it as it was, and a new print after the change is a new slip. Archived orders reprint as they
were archived.

## What changed with gift fields

These print differently from before, even with nothing mapped:

- private common fields (`__gift-note`, `_giftnote_message`) now count;
- Giftnote's `giftnote_message`, `giftnote_to` and `giftnote_from` are common fields, so To
  and From lines print;
- a common message field Floormode could not keep now makes the order a gift (before, it
  did not).

The single field of the old **Gift field** setting is not carried over: map it again.

## For developers

`packing_slip_settings_get` / `_set` (REST and MCP) carry `giftFields`, `commonGiftFields`
and `giftNoteOnSlip`. `orders_get.gift` and `packing_get.gift` answer
`{ message, to, from, field, unavailable }`. `values_suggest` with
`facet: "order_attribute_key"` lists your orders' field names with their order counts.

## See also

- [Pack](/features/fulfillment/pack/)
- [Inserts](/features/fulfillment/inserts/)

<DocUpdated date="2026-11-18" />