Cart note

An order-note field for gift messages or delivery instructions. It saves to the Shopify cart as the shopper types and comes back pre-filled when they return.

<label for="order-note">Order note</label>
<cart-note debounce="500">
  <textarea id="order-note" rows="3" placeholder="Gift message, delivery instructions…"></textarea>
</cart-note>

• <cart-note> wraps your own <textarea> or <input>. It seeds the field once from the loaded cart and never overwrites what someone is typing.
• It saves on debounced input (500 ms by default). There is no save button to author.
• The component doesn’t name the field. The <label> or an aria-label is on you, and the validator enforces it (SSK-501).

Options

Tag	Attribute	Type / default	What it does
cart-note	debounce	number, 500	Milliseconds of typing pause before the note saves.

When the attribute is absent, cart-note reads noteDebounce from the centralized config block’s cart group.

Gotchas

• The note doesn’t save without a nested field, or without a <storesynk-store> ancestor (SSK-101). See cart troubleshooting.
• A bare field is flagged as SSK-501. A placeholder is not a name.

Related

• Cart drawer
• Discount codes
• Cart tag reference