[{"data":1,"prerenderedAt":570},["ShallowReactive",2],{"navigation_docs":3,"-en-articles-add-a-gift-message-input-to-shopify-checkout":247,"-en-articles-add-a-gift-message-input-to-shopify-checkout-surround":567},[4],{"title":5,"path":6,"stem":7,"children":8,"page":246},"En","\u002Fen","en",[9],{"title":10,"path":11,"stem":12,"children":13,"page":246},"Articles","\u002Fen\u002Farticles","en\u002Farticles",[14,18,22,26,30,34,38,42,46,50,54,58,62,66,70,74,78,82,86,90,94,98,102,106,110,114,118,122,126,130,134,138,142,146,150,154,158,162,166,170,174,178,182,186,190,194,198,202,206,210,214,218,222,226,230,234,238,242],{"title":15,"path":16,"stem":17},"How to Add Custom Gift Messages to Your Shopify Store: A Complete Guide","\u002Fen\u002Farticles\u002F10138063-how-to-add-custom-gift-messages-to-your-shopify-store-a-complete-guide","en\u002Farticles\u002F10138063-how-to-add-custom-gift-messages-to-your-shopify-store-a-complete-guide",{"title":19,"path":20,"stem":21},"Setting Up Flows: A Complete Guide","\u002Fen\u002Farticles\u002F10330120-setting-up-flows-a-complete-guide","en\u002Farticles\u002F10330120-setting-up-flows-a-complete-guide",{"title":23,"path":24,"stem":25},"Welcome to Yuzu","\u002Fen\u002Farticles\u002F10351529-welcome-to-yuzu","en\u002Farticles\u002F10351529-welcome-to-yuzu",{"title":27,"path":28,"stem":29},"Setting up your account","\u002Fen\u002Farticles\u002F10351539-setting-up-your-account","en\u002Farticles\u002F10351539-setting-up-your-account",{"title":31,"path":32,"stem":33},"Understanding Personalization: How Apps Shape Your Campaigns","\u002Fen\u002Farticles\u002F10351569-understanding-personalization-how-apps-shape-your-campaigns","en\u002Farticles\u002F10351569-understanding-personalization-how-apps-shape-your-campaigns",{"title":35,"path":36,"stem":37},"Designing Templates: Bringing Personalization to Life","\u002Fen\u002Farticles\u002F10351581-designing-templates-bringing-personalization-to-life","en\u002Farticles\u002F10351581-designing-templates-bringing-personalization-to-life",{"title":39,"path":40,"stem":41},"Setting Up Flows: Automating Your Campaigns","\u002Fen\u002Farticles\u002F10351587-setting-up-flows-automating-your-campaigns","en\u002Farticles\u002F10351587-setting-up-flows-automating-your-campaigns",{"title":43,"path":44,"stem":45},"Testing Your Campaign","\u002Fen\u002Farticles\u002F10351599-testing-your-campaign","en\u002Farticles\u002F10351599-testing-your-campaign",{"title":47,"path":48,"stem":49},"Examples of Marketing Initiatives","\u002Fen\u002Farticles\u002F10351604-examples-of-marketing-initiatives","en\u002Farticles\u002F10351604-examples-of-marketing-initiatives",{"title":51,"path":52,"stem":53},"Troubleshooting Flows & Templates","\u002Fen\u002Farticles\u002F10351611-troubleshooting-flows-templates","en\u002Farticles\u002F10351611-troubleshooting-flows-templates",{"title":55,"path":56,"stem":57},"Printers and Warehousing Essentials","\u002Fen\u002Farticles\u002F10351628-printers-and-warehousing-essentials","en\u002Farticles\u002F10351628-printers-and-warehousing-essentials",{"title":59,"path":60,"stem":61},"Installing the Yuzu Print App and Connecting Your Printer","\u002Fen\u002Farticles\u002F10351636-installing-the-yuzu-print-app-and-connecting-your-printer","en\u002Farticles\u002F10351636-installing-the-yuzu-print-app-and-connecting-your-printer",{"title":63,"path":64,"stem":65},"Automating Printing with Warehouse Management Systems (WMS)","\u002Fen\u002Farticles\u002F10351641-automating-printing-with-warehouse-management-systems-wms","en\u002Farticles\u002F10351641-automating-printing-with-warehouse-management-systems-wms",{"title":67,"path":68,"stem":69},"Navigating the Orders Table: Managing and Monitoring Orders","\u002Fen\u002Farticles\u002F10351860-navigating-the-orders-table-managing-and-monitoring-orders","en\u002Farticles\u002F10351860-navigating-the-orders-table-managing-and-monitoring-orders",{"title":71,"path":72,"stem":73},"Troubleshooting Printing: Common Issues and Quick Fixes","\u002Fen\u002Farticles\u002F10351862-troubleshooting-printing-common-issues-and-quick-fixes","en\u002Farticles\u002F10351862-troubleshooting-printing-common-issues-and-quick-fixes",{"title":75,"path":76,"stem":77},"Ordering Cardstock & Compatible Printers","\u002Fen\u002Farticles\u002F10351866-ordering-cardstock-compatible-printers","en\u002Farticles\u002F10351866-ordering-cardstock-compatible-printers",{"title":79,"path":80,"stem":81},"Shopify Integration: Setup, Features, and Variables","\u002Fen\u002Farticles\u002F10351896-shopify-integration-setup-features-and-variables","en\u002Farticles\u002F10351896-shopify-integration-setup-features-and-variables",{"title":83,"path":84,"stem":85},"Klaviyo Integration","\u002Fen\u002Farticles\u002F10351900-klaviyo-integration","en\u002Farticles\u002F10351900-klaviyo-integration",{"title":87,"path":88,"stem":89},"ShipStation Integration","\u002Fen\u002Farticles\u002F10351910-shipstation-integration","en\u002Farticles\u002F10351910-shipstation-integration",{"title":91,"path":92,"stem":93},"ShipHero Integration","\u002Fen\u002Farticles\u002F10351924-shiphero-integration","en\u002Farticles\u002F10351924-shiphero-integration",{"title":95,"path":96,"stem":97},"SKULabs Integration","\u002Fen\u002Farticles\u002F10351928-skulabs-integration","en\u002Farticles\u002F10351928-skulabs-integration",{"title":99,"path":100,"stem":101},"ShippingEasy Integration","\u002Fen\u002Farticles\u002F10351934-shippingeasy-integration","en\u002Farticles\u002F10351934-shippingeasy-integration",{"title":103,"path":104,"stem":105},"Editing Profiles and Managing Team Members","\u002Fen\u002Farticles\u002F10351940-editing-profiles-and-managing-team-members","en\u002Farticles\u002F10351940-editing-profiles-and-managing-team-members",{"title":107,"path":108,"stem":109},"Billing and Subscription Overview","\u002Fen\u002Farticles\u002F10351943-billing-and-subscription-overview","en\u002Farticles\u002F10351943-billing-and-subscription-overview",{"title":111,"path":112,"stem":113},"Print Quality Standards for Inserts (3PL Reference Guide)","\u002Fen\u002Farticles\u002F11004459-print-quality-standards-for-inserts-3pl-reference-guide","en\u002Farticles\u002F11004459-print-quality-standards-for-inserts-3pl-reference-guide",{"title":115,"path":116,"stem":117},"Integrations list","\u002Fen\u002Farticles\u002F11625993-integrations-list","en\u002Farticles\u002F11625993-integrations-list",{"title":119,"path":120,"stem":121},"How to Send Smart QR Scan Events to Triple Whale","\u002Fen\u002Farticles\u002F14720901-how-to-send-smart-qr-scan-events-to-triple-whale","en\u002Farticles\u002F14720901-how-to-send-smart-qr-scan-events-to-triple-whale",{"title":123,"path":124,"stem":125},"Use Yuzu Print Extension with Shippo","\u002Fen\u002Farticles\u002F14828930-use-yuzu-print-extension-with-shippo","en\u002Farticles\u002F14828930-use-yuzu-print-extension-with-shippo",{"title":127,"path":128,"stem":129},"Use Yuzu Print Extension with NetSuite","\u002Fen\u002Farticles\u002F14831100-use-yuzu-print-extension-with-netsuite","en\u002Farticles\u002F14831100-use-yuzu-print-extension-with-netsuite",{"title":131,"path":132,"stem":133},"Use Yuzu Print Extension with Redo","\u002Fen\u002Farticles\u002F14831104-use-yuzu-print-extension-with-redo","en\u002Farticles\u002F14831104-use-yuzu-print-extension-with-redo",{"title":135,"path":136,"stem":137},"Use Yuzu Print Extension with Linnworks","\u002Fen\u002Farticles\u002F14831108-use-yuzu-print-extension-with-linnworks","en\u002Farticles\u002F14831108-use-yuzu-print-extension-with-linnworks",{"title":139,"path":140,"stem":141},"Use Yuzu Print Extension with Helm","\u002Fen\u002Farticles\u002F14831111-use-yuzu-print-extension-with-helm","en\u002Farticles\u002F14831111-use-yuzu-print-extension-with-helm",{"title":143,"path":144,"stem":145},"Use Yuzu Print Extension with Veeqo","\u002Fen\u002Farticles\u002F14831114-use-yuzu-print-extension-with-veeqo","en\u002Farticles\u002F14831114-use-yuzu-print-extension-with-veeqo",{"title":147,"path":148,"stem":149},"Use Yuzu Print Extension with Veracore","\u002Fen\u002Farticles\u002F14831116-use-yuzu-print-extension-with-veracore","en\u002Farticles\u002F14831116-use-yuzu-print-extension-with-veracore",{"title":151,"path":152,"stem":153},"Use Yuzu Print Extension with Acumatica","\u002Fen\u002Farticles\u002F14831117-use-yuzu-print-extension-with-acumatica","en\u002Farticles\u002F14831117-use-yuzu-print-extension-with-acumatica",{"title":155,"path":156,"stem":157},"Use Yuzu Print Extension with Fulfil","\u002Fen\u002Farticles\u002F14831118-use-yuzu-print-extension-with-fulfil","en\u002Farticles\u002F14831118-use-yuzu-print-extension-with-fulfil",{"title":159,"path":160,"stem":161},"Use Yuzu Print Extension with Extensiv","\u002Fen\u002Farticles\u002F14831122-use-yuzu-print-extension-with-extensiv","en\u002Farticles\u002F14831122-use-yuzu-print-extension-with-extensiv",{"title":163,"path":164,"stem":165},"Use Yuzu Print Extension with ShipHero","\u002Fen\u002Farticles\u002F14831123-use-yuzu-print-extension-with-shiphero","en\u002Farticles\u002F14831123-use-yuzu-print-extension-with-shiphero",{"title":167,"path":168,"stem":169},"Use Yuzu Print Extension with Deposco","\u002Fen\u002Farticles\u002F14831127-use-yuzu-print-extension-with-deposco","en\u002Farticles\u002F14831127-use-yuzu-print-extension-with-deposco",{"title":171,"path":172,"stem":173},"Use Yuzu Print Extension with ShipStation","\u002Fen\u002Farticles\u002F14831128-use-yuzu-print-extension-with-shipstation","en\u002Farticles\u002F14831128-use-yuzu-print-extension-with-shipstation",{"title":175,"path":176,"stem":177},"Use Yuzu Print Client with Mintsoft","\u002Fen\u002Farticles\u002F14831131-use-yuzu-print-client-with-mintsoft","en\u002Farticles\u002F14831131-use-yuzu-print-client-with-mintsoft",{"title":179,"path":180,"stem":181},"Create a Yuzu API key and choose an App ID","\u002Fen\u002Farticles\u002F14831365-create-a-yuzu-api-key-and-choose-an-app-id","en\u002Farticles\u002F14831365-create-a-yuzu-api-key-and-choose-an-app-id",{"title":183,"path":184,"stem":185},"Find printer IDs and set a printer override","\u002Fen\u002Farticles\u002F14831367-find-printer-ids-and-set-a-printer-override","en\u002Farticles\u002F14831367-find-printer-ids-and-set-a-printer-override",{"title":187,"path":188,"stem":189},"Set up tag-based printer routing in Yuzu Print Extension","\u002Fen\u002Farticles\u002F14831368-set-up-tag-based-printer-routing-in-yuzu-print-extension","en\u002Farticles\u002F14831368-set-up-tag-based-printer-routing-in-yuzu-print-extension",{"title":191,"path":192,"stem":193},"Install and configure Yuzu Print Extension","\u002Fen\u002Farticles\u002F14831371-install-and-configure-yuzu-print-extension","en\u002Farticles\u002F14831371-install-and-configure-yuzu-print-extension",{"title":195,"path":196,"stem":197},"Share Yuzu Print Extension configuration between benches","\u002Fen\u002Farticles\u002F14831374-share-yuzu-print-extension-configuration-between-benches","en\u002Farticles\u002F14831374-share-yuzu-print-extension-configuration-between-benches",{"title":199,"path":200,"stem":201},"Understand Yuzu Print Extension notifications","\u002Fen\u002Farticles\u002F14831377-understand-yuzu-print-extension-notifications","en\u002Farticles\u002F14831377-understand-yuzu-print-extension-notifications",{"title":203,"path":204,"stem":205},"Set up 3PL mode in Yuzu Print Extension","\u002Fen\u002Farticles\u002F14831379-set-up-3pl-mode-in-yuzu-print-extension","en\u002Farticles\u002F14831379-set-up-3pl-mode-in-yuzu-print-extension",{"title":207,"path":208,"stem":209},"Use a custom domain with Yuzu Print Extension","\u002Fen\u002Farticles\u002F14831381-use-a-custom-domain-with-yuzu-print-extension","en\u002Farticles\u002F14831381-use-a-custom-domain-with-yuzu-print-extension",{"title":211,"path":212,"stem":213},"Troubleshoot Yuzu Print Extension printing issues","\u002Fen\u002Farticles\u002F14831383-troubleshoot-yuzu-print-extension-printing-issues","en\u002Farticles\u002F14831383-troubleshoot-yuzu-print-extension-printing-issues",{"title":215,"path":216,"stem":217},"Import Yuzu templates from Figma","\u002Fen\u002Farticles\u002F15359231-import-yuzu-templates-from-figma","en\u002Farticles\u002F15359231-import-yuzu-templates-from-figma",{"title":219,"path":220,"stem":221},"Manage merchant teams with the Yuzu 3PL Partner API","\u002Fen\u002Farticles\u002F15925381-manage-merchant-teams-with-the-yuzu-3pl-partner-api","en\u002Farticles\u002F15925381-manage-merchant-teams-with-the-yuzu-3pl-partner-api",{"title":223,"path":224,"stem":225},"Add or edit a Giftie greeting card on an existing Shopify order","\u002Fen\u002Farticles\u002F16150958-add-or-edit-a-giftie-greeting-card-on-an-existing-shopify-order","en\u002Farticles\u002F16150958-add-or-edit-a-giftie-greeting-card-on-an-existing-shopify-order",{"title":227,"path":228,"stem":229},"Using custom CSS on the Giftie greeting card product page","\u002Fen\u002Farticles\u002F16198173-using-custom-css-on-the-giftie-greeting-card-product-page","en\u002Farticles\u002F16198173-using-custom-css-on-the-giftie-greeting-card-product-page",{"title":231,"path":232,"stem":233},"What to do when no printable documents are found","\u002Fen\u002Farticles\u002F16788407-what-to-do-when-no-printable-documents-are-found","en\u002Farticles\u002F16788407-what-to-do-when-no-printable-documents-are-found",{"title":235,"path":236,"stem":237},"Connect Fulfil to Yuzu and renew your API key","\u002Fen\u002Farticles\u002F17002069-connect-fulfil-to-yuzu-and-renew-your-api-key","en\u002Farticles\u002F17002069-connect-fulfil-to-yuzu-and-renew-your-api-key",{"title":239,"path":240,"stem":241},"Install Yuzu Printer Monitor on Windows","\u002Fen\u002Farticles\u002F17636600-install-yuzu-printer-monitor-on-windows","en\u002Farticles\u002F17636600-install-yuzu-printer-monitor-on-windows",{"title":243,"path":244,"stem":245},"Add a Giftie gift message input to Shopify checkout","\u002Fen\u002Farticles\u002Fadd-a-gift-message-input-to-shopify-checkout","en\u002Farticles\u002Fadd-a-gift-message-input-to-shopify-checkout",false,{"id":248,"title":243,"body":249,"description":557,"extension":558,"links":559,"meta":560,"modifiedAt":563,"navigation":564,"path":244,"seo":565,"stem":245,"__hash__":566},"docs\u002Fen\u002Farticles\u002Fadd-a-gift-message-input-to-shopify-checkout.md",{"type":250,"value":251,"toc":543},"minimark",[252,261,266,291,295,336,346,350,357,360,377,380,384,390,400,411,415,418,421,453,458,465,468,479,483,494,498,535],[253,254,255,256,260],"p",{},"Use Giftie's ",[257,258,259],"strong",{},"Gift Message"," checkout block to let customers write a gift message before placing their order. The same block can also let them add a greeting card by picking a card design.",[262,263,265],"h2",{"id":264},"before-you-start","Before you start",[267,268,269,273,288],"ul",{},[270,271,272],"li",{},"Install Giftie on the Shopify store you want to configure.",[270,274,275,276,279,280,287],{},"Your store needs ",[257,277,278],{},"Shopify Plus"," to use this block in checkout. For testing, use a Plus development store. A Basic development store does not provide the same checkout access. See ",[281,282,286],"a",{"href":283,"rel":284},"https:\u002F\u002Fshopify.dev\u002Fdocs\u002Fapi\u002Fcheckout-ui-extensions\u002Flatest",[285],"nofollow","Shopify's checkout extension requirements",".",[270,289,290],{},"You need permission to customize the store's checkout.",[262,292,294],{"id":293},"add-the-gift-message-block","Add the Gift Message block",[296,297,298,304,310,317,327,330],"ol",{},[270,299,300,301,287],{},"In Shopify admin, go to ",[257,302,303],{},"Settings → Checkout",[270,305,306,307,287],{},"Find the checkout configuration you want to edit and select ",[257,308,309],{},"Customize",[270,311,312,313,316],{},"Select the ",[257,314,315],{},"Checkout"," page in the editor.",[270,318,319,320,323,324,326],{},"Open ",[257,321,322],{},"Apps",", find Giftie, and add the ",[257,325,259],{}," block.",[270,328,329],{},"Place the block where you want customers to enter their message.",[270,331,332,333,287],{},"Select ",[257,334,335],{},"Save",[253,337,338,339,341,342,345],{},"If ",[257,340,259],{}," is missing from the app list, confirm that Giftie is installed on this store and that the store has Shopify Plus checkout access. Giftie's other blocks, such as ",[257,343,344],{},"Scheduled gifts",", serve different pages and do not add this input.",[262,347,349],{"id":348},"show-the-input-immediately","Show the input immediately",[253,351,352,353,356],{},"By default, customers turn on ",[257,354,355],{},"Add a gift message"," before the input appears.",[253,358,359],{},"To keep the input visible:",[296,361,362,367,373],{},[270,363,312,364,366],{},[257,365,259],{}," block in the checkout editor.",[270,368,369,370,287],{},"Turn off ",[257,371,372],{},"Show opt-in toggle",[270,374,332,375,287],{},[257,376,335],{},[253,378,379],{},"Customers can then type directly into the box without turning on a switch.",[262,381,383],{"id":382},"configure-the-message-field","Configure the message field",[253,385,386,387,287],{},"The block's settings let you add helper text, set the maximum number of characters, and provide quick-pick suggestions, one per line. The default limit is ",[257,388,389],{},"200 characters",[253,391,392,395,396,399],{},[257,393,394],{},"Textarea placeholder"," supplies example text shown below an empty input. ",[257,397,398],{},"Learn more URL"," adds an optional link below the field.",[253,401,402,403,406,407,410],{},"Messages save automatically. The field shows ",[257,404,405],{},"Saving...",", followed by ",[257,408,409],{},"Saved"," when an update succeeds. Some accelerated checkout methods restrict attribute updates; use the standard checkout to test the field.",[262,412,414],{"id":413},"offer-greeting-card-designs","Offer greeting card designs",[253,416,417],{},"The block can show the designs of your Giftie greeting card product as small images. When a customer selects a design, Giftie adds that card to the cart at the card's normal price. Customers do not have to pick a card.",[253,419,420],{},"To turn this on:",[296,422,423,427,436,449],{},[270,424,312,425,366],{},[257,426,259],{},[270,428,429,430,432,433,287],{},"Set ",[257,431,414],{}," to ",[257,434,435],{},"True",[270,437,438,439,432,442,444,445,448],{},"To show the designs below the message field, set ",[257,440,441],{},"Show card designs below the message",[257,443,435],{},". Keep ",[257,446,447],{},"False"," to show them above it.",[270,450,332,451,287],{},[257,452,335],{},[454,455,457],"h3",{"id":456},"which-designs-customers-see","Which designs customers see",[253,459,460,461,464],{},"Giftie finds your greeting card product automatically and shows ",[257,462,463],{},"every design"," of it. You do not choose the product or individual designs in the checkout editor.",[253,466,467],{},"Each design is one variant of the product, with its own image and price. To hide a design, make that variant unavailable for sale. Giftie skips variants that are not available for sale or have no image.",[253,469,470,471,474,475,478],{},"The product must be ",[257,472,473],{},"Active"," and available on the ",[257,476,477],{},"Online Store"," sales channel. If no designs appear, check both in Shopify admin.",[454,480,482],{"id":481},"in-checkout","In checkout",[267,484,485,488,491],{},[270,486,487],{},"Customers select a design to add the card. Selecting another design changes the card, and selecting the same design again removes it.",[270,489,490],{},"Up to six designs show at a time. Arrows appear when there are more.",[270,492,493],{},"The card appears in the order summary and on the order as a normal line item.",[262,495,497],{"id":496},"test-a-message","Test a message",[296,499,500,503,508,514,517],{},[270,501,502],{},"Open the storefront, add a product to the cart, and go to checkout.",[270,504,505,506,287],{},"If the switch is visible, turn on ",[257,507,355],{},[270,509,510,511,513],{},"Enter a recognizable test message and wait for ",[257,512,409],{},".\nIf you set up card designs, select one and check that the card appears in the order summary.",[270,515,516],{},"Complete a test order using your development store's test payment gateway or an enabled manual payment method.",[270,518,519,520,523,524,527,528,530,531,534],{},"Open the order in Shopify admin and check ",[257,521,522],{},"Additional details"," for the message. Giftie saves it as an order attribute, normally ",[257,525,526],{},"yuzuGiftMessage",", or ",[257,529,259],{}," when that existing attribute is being used. It is separate from the order's ",[257,532,533],{},"Notes"," field. A card you selected appears as its own line item on the order.",[253,536,537,538,542],{},"If the message is missing, check for a save error in checkout and confirm that you are viewing the order from the same test. Send the order number and a screenshot to ",[281,539,541],{"href":540},"mailto:team@yuzu.so","team@yuzu.so"," if it still does not appear.",{"title":544,"searchDepth":545,"depth":545,"links":546},"",2,[547,548,549,550,551,556],{"id":264,"depth":545,"text":265},{"id":293,"depth":545,"text":294},{"id":348,"depth":545,"text":349},{"id":382,"depth":545,"text":383},{"id":413,"depth":545,"text":414,"children":552},[553,555],{"id":456,"depth":554,"text":457},3,{"id":481,"depth":554,"text":482},{"id":496,"depth":545,"text":497},"Add the Gift Message block to your Shopify Plus checkout, choose how the input appears, offer greeting card designs, and test that messages and cards are saved with orders.","md",null,{"category":561,"brand":562},"giftie","Giftie","2026-11-05T00:00:00Z",true,{"title":243,"description":557},"1u_BQLUw2uoViXYc3i-mwtKFziIwjohLqNSeWRTBNuE",[568,559],{"title":239,"path":240,"stem":241,"description":569,"children":-1},"Connect Yuzu Printer Monitor (Beta) on your Windows print computer and check that it is reporting to Yuzu.",1793887381698]