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
Custom forms can be used with Giftnote. The order messages will need to be set up separately for orders and gift cards. This guide is intended for developers or experts with the Shopify theme.
Please contact our team if there are any questions
Order message
These custom attributes need to be added to the "order_attributes" to the customer's cart to ensure that the widget is properly integrated with Giftnote
- giftnote_to: Who the message is for
- giftnote_message: The message from the customer
- giftnote_from: Who is sending the message.
- giftnote_medium: no longer read by Giftnote — remove it. Delivery medium is derived automatically from whichever of giftnote_email / giftnote_phone you set (set both for "both").
- giftnote_email: Required if the medium is email/both
- giftnote_phone: Required if the medium is phone/both. Must be a mobile number and in E.164 format
- giftnote_method: "instant" | "scheduled" | "tracked". Send the message immediately, at the scheduled time, or when the order is delivered.
- giftnote_time: Only required when "method" is set to "scheduled". It must be in ISO format
Gift card message
Gift card messages are not set as order attributes. They are added to the "line_item_properties" of the gift card line item inside the cart. For the exact property names Giftnote reads on a gift card line item, see the Giftnote Order Attribute Schema Reference.
If this doesn't match what you see, chat with us or email support@giftnote.com.
Reading these values back from the order. Giftnote stores the message in a Shopify metafield. If your theme or a downstream integration reads giftnote_* note attributes from the order, turn on Keep Order Attributes in Settings → Gift Orders → Advanced settings. It is off by default.