5. Add Checkout & Post-Purchase Extensions
How to add the Giftnote checkout and order status page extensions, and where their settings now live in the app.
Written By Giftnote Team
Last updated About 1 hour ago
1. Giftnote checkout extension (Shopify Plus only)
This feature is exclusive to Shopify Plus.
Let customers leave a personalized gift message directly at checkout. No extra steps. Fully native.
1. Enable the Giftnote checkout widget
- Go to Shopify Admin → Settings → Checkout
- Click Customize
- In the checkout editor, click Add block
- Under Giftnote: Engine for Gifting, choose Gift Message — do NOT choose "[DEPRECATED] Gift Message", which is the legacy v1 block kept only for stores that already had it placed
![Shopify checkout editor: Add block list open, with the Giftnote: Engine for Gifting group showing [DEPRECATED] Gift Message and Gift Message](https://689448d2a73fbf3cb036edde.featurebase-attachments.com/c/article/68ee8c18b7938b12cbe2465a/01a0da2b-0e3a-7694-8b4a-21702d0c21f9/b64u-MDFhMGRhMmItMGRlNC03MTNkLTk4ZGEtNDA3ZjA0NzVjYTVi.png?X-Amz-Expires=3600&X-Amz-Date=20260925T220000Z&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=DO801TYC4FCVNNEKURKM%2F20260925%2Ffra1%2Fs3%2Faws4_request&X-Amz-SignedHeaders=host&X-Amz-Signature=d2ca5758189f8b58fc750c3bc3be58b54386332ef40f238831a50e2b50b97d75)
- Click Enable block
- If your customers use Shop Pay: In the checkout editor, select the Gift Message block and, under Checkout behavior, make sure Include block in Shop Pay is on. Then run a test checkout with Shop Pay and check the gift message option appears.

You can drag the block anywhere on the checkout page. Unlike the legacy block, the current Gift Message block has no Giftnote settings of its own in the checkout editor (only Shopify's Checkout behavior options) — everything else is configured from inside the Giftnote app instead.
2. Customize widget settings (in the Giftnote app)
Delivery-method and copy settings for this placement live in a named Design:
- Go to Settings → Gift Orders and click Configure on the Checkout card
- Under Where each design shows up, open the design chosen for Checkout widget (or create one with New design) and select the Checkout tab
- Here you can set the default delivery method (Send Now / Send Later / On Delivery / On Fulfillment), and turn on Hide ‘On Delivery’ option, Hide phone input or Hide for B2B customers
A separate set of settings applies to the whole storefront regardless of which Design is active, and lives on a different page:
- Go to Settings → Gift Orders and click Advanced settings
- In the Surcharge & visibility card you'll find the surcharge product variant (Shopify Plus only), Hidden products (products where the gift message option won't show on the product page), and Blocked markets (countries where the gift message option is hidden)
3. Optional: charge for gift messages
If you want to monetize the widget:
- Create a digital product in Shopify (e.g. "Digital Gift Message")
- In the Giftnote app, go to Settings → Gift Orders → Advanced settings and select the product's variant in the Surcharge & visibility card. Save if a save bar appears.
The surcharge is Shopify Plus only. When a customer adds a gift message, the current Gift Message checkout block adds one marked surcharge line to the order. If they remove the message, the block removes the line.
You can also use this to upsell gift wrapping or other gifting extras, with the Giftnote message included as part of it.
For the full setup, see "Upselling and Charging for Giftnote at Checkout on Shopify Plus".
4. Troubleshooting
- Not appearing in checkout? Confirm you're on Shopify Plus and that you added the current Gift Message block (not the deprecated one) to the checkout template.
- Need to hide the gift message option for some products? Use Hidden products on Settings → Gift Orders → Advanced settings. It hides the option on the product page, so test your checkout separately.
Notes
- Requires Shopify's Checkout Extensibility
- Not compatible with vintage checkout or third-party gift card products
- Ideal for brands who want to offer premium gift options natively
2. Enable gift messages on the order status page (all Shopify plans)
Giftnote's Order Status Page widget lets customers add or edit a gift message after completing checkout.
Available to all Shopify merchants — no Plus plan required.
Step 1: Add the Giftnote widget to the order status page
- In Shopify Admin, go to Settings → Checkout, click Customize
- Toggle the view to "Order Status Page" at the top
- Click Add App Block, then select Gift Message
- Place the block where you want it to appear and click Save. You can drag it above or below existing blocks for better visibility.
In the Giftnote app, Edit in checkout next to the Gift Orders Message (Order status) row on Settings → Overview opens the checkout editor.
Customers can now:
- Add a gift message if they didn't earlier
- Edit their message before it's sent
All from the order status (thank you) page.
Step 2: Configure widget settings in Giftnote
- In Shopify Admin, go to Apps → Giftnote
- Go to Settings → Gift Orders, click Configure on the Order Status card, open the design chosen for Order status widget and select the Order status tab for delivery-method/copy options
- Go to Settings → Gift Orders → Advanced settings for Hidden products and Blocked markets
In the design's Order status tab you can set:
- The default delivery method
- Hide 'On Delivery' option
- Hide phone input
- The widget copy and labels
Save your changes. After saving, refresh the checkout editor in Shopify to see your updates.
Step 3: Add a link to the Shopify order confirmation email
To drive post-purchase engagement, add a direct link that lets customers add or update their gift message from the confirmation email.
- Open your Shopify notifications. Go to Settings → Notifications in Shopify.
- Edit the email. Open the Order confirmation and/or Shipping confirmation template.
- Paste the snippet. Add the following wherever it fits best. You can add your own styling.
{% comment %} Gift Message Email Block for Shopify Order Confirmation Emails {% endcomment %}
<br>
{% assign giftnote_attribute_count = 0 %}
{% for attribute in order.attributes %}
{% if attribute.first contains 'giftnote_' %}
{% increment giftnote_attribute_count %}
{% endif %}
{% endfor %}
<h4 style="margin-top: 20px;">
{% if giftnote_attribute_count > 1 %}
Your gift purchase 🎁
{% else %}
Purchasing as a gift? 🎁
{% endif %}
</h4>
<a href="{{ order.order_status_url }}">
{% if giftnote_attribute_count > 1 %}
View and edit your gift message
{% else %}
Add a gift message to your order
{% endif %}
</a>
{% comment %} Gift Message Email Block for Shopify Order Confirmation Emails {% endcomment %}
You can change the text to suit your tone or branding.
The snippet decides which text to show by looking for giftnote_* order attributes. Giftnote itself doesn't need these attributes, so they're only written when Keep Order Attributes is on. To use this snippet, turn on Keep Order Attributes in Settings → Gift Orders → Advanced settings. If your shop had it on before our big September 2026 update, it stays on.
If you need help with this, chat with us using the chat button in the help centre or in the app, or email support@giftnote.com.
Metafields vs order attributes
Giftnote writes to Shopify Metafields (the giftnote.gift_message metafield), not order attributes, so this keeps your order data cleaner and integrates better with Klaviyo, Shopify Flow, and other apps. Giftnote's own processing uses the metafield. Cart-attribute (giftnote_*) input is still accepted for custom-theme integrations — see the "Custom Widget for Messages" article — but the metafield is the canonical stored value. Keep Order Attributes is optional compatibility output: if your theme, packing slips, Shopify Flow, Order Printer or 3PL read note attributes, turn it on in Settings → Gift Orders → Advanced settings to also write the giftnote_* note attributes onto orders. Shops that had it on before the September update keep it.
Use cases for order status gifting
- A customer forgets to include a gift message at checkout
- Someone realises post-purchase they sent the gift to a recipient
- You want to boost participation in gifting without disrupting purchase flow
- You want to reduce customer support enquiries