3. Custom Widget for Messages
The cart attributes to set when building a custom gift-message widget, and which ones Giftnote actually reads.
Written By Giftnote Admin
Last updated About 1 hour ago
Custom forms with Giftnote
You only need this if a developer is building your own gift message form instead of using the Giftnote widget. It lists what the form must add to the cart so Giftnote picks up the message. Gift orders and gift cards work differently, so each has its own section below.
Questions? Chat with us using the chat button in the help centre or in the app, or email support@giftnote.com.
Order message
Add these attributes to the customer's cart as order attributes (Shopify cart attributes, stored on the order as note_attributes):
- giftnote_to: who the message is for
- giftnote_message: the customer's message
- giftnote_from: who is sending it
- giftnote_email: the recipient's email. Send it for email delivery.
- giftnote_phone: the recipient's mobile number in E.164 format, for example +447911123456. Send it for SMS delivery.
- giftnote_method: "instant", "scheduled" or "tracked". Sends the message straight away, at the scheduled time, or when the order is delivered.
- giftnote_time: only needed when the method is "scheduled". Use ISO 8601 format.
Don't send giftnote_medium. Giftnote ignores it and picks the channel from the contact details you send: email, phone or both.
Gift card message
Gift card messages don't go in order attributes. Add them as line item properties on the gift card line in the cart. The exact property names are in the Giftnote Order Attribute Schema Reference.
Reading the message back from the order. Giftnote saves the message in the order's giftnote.gift_message metafield, which is the best place to read it. If your theme or another tool reads giftnote_* note attributes from the order instead, Keep Order Attributes must be on in Settings → Gift Orders → Advanced settings. Once it's turned off, only Giftnote support can turn it back on.