Shopify is one of the most popular eCommerce platforms and integrates seamlessly with Yuzu to enable personalized printing and automated workflows. This guide covers everything you need to know about connecting Shopify to Yuzu, the data available for personalization, and key use cases.
App Type
Shopify is an eCommerce platform, providing your store’s order, product, and customer data to Yuzu for personalization and automation.
Standard Variables Pulled Through
When you connect Shopify to Yuzu, the following standard variables are automatically synced:
Order Data
Order ID
Order date
Total value
Discounts applied
Order tags
Customer Data
Customer name (First name, Last name)
Email address
Phone number
Shipping address
Order count
Lifetime value (amount and currency)
Average order value (amount and currency)
Customer tags
Product Data
Product titles
Quantities
SKUs
Variant options
Product image URLs
Custom Variables Accessible
In addition to standard data, Yuzu can access custom fields from Shopify to enhance your personalization capabilities:
Meta Fields
Custom data fields for orders or products (e.g., engraving details).
Enriched Data
Additional fields created through custom Shopify setups or API integrations.
Order and Product Line Item Attributes
Attributes specific to individual order line items or product line items (e.g., custom selections, personalization options).
For detailed instructions on how to add custom fields like gift messages, see our guide: How to Add Custom Gift Messages to Your Shopify Store: A Complete Guide.
Select Shopify custom fields in the variable picker
You can select Shopify order metafields, order/cart attributes, and line item properties directly in Yuzu’s variable picker. You do not need to write a custom variable mapper just to read one named field. Product and variant metafields are also available after you enable their import.
Choose a field
Open the variable picker in your template or flow and find your connected Shopify app.
Choose the relevant field group, such as Metafield, Custom attribute, or Line item attribute. Select the correct store if your team has more than one Shopify connection.
Select a suggested key. Suggestions come from a sample of recent orders, so a field that is new or used rarely may not appear yet. You can enter its key in the “Other…” field instead.
For an order metafield, enter its key, such as
custom_message. For a product or variant metafield, usenamespace.key, such ascustom.engraving. For an attribute, use its name, such asGift Message.If product or variant metafields show “Not imported yet,” enable their import. These fields become available as new orders arrive; enabling the import does not backfill existing orders.
Check the value on a representative order before using it in a live template or flow. A missing field returns no value.
Selecting or entering a key creates a reusable variable in Yuzu. Yuzu handles the field lookup for you. Custom mappers remain useful when you need additional logic, such as combining fields or transforming a value.
Use a different gift message for each item
Save each customer’s message as a Shopify line item property, for example properties[Gift Message] in the product form. Shopify exposes this on the order as a line item custom attribute. Shopify order line items do not support metafields; product and variant metafields describe the catalog item, rather than a message for one purchase.
In Yuzu, use a line item loop and select the attribute in line item scope. This reads the message for the item currently being processed. The order-scoped version reads only the first matching value across the items, so it does not create a separate note for every item.
Add a document for each item with a non-empty message. The field selection alone does not change an existing order-level flow or create extra documents. If a customer buys two of the same product with different messages, keep them as separate cart lines with their own properties.
Test an order with several different messages before launch. If a warehouse or 3PL retrieves the PDFs, also check how it handles multiple documents, page sizes, and any packing barcode or QR code.
Features and Use Cases
Dynamic Personalization and Targeted Marketing
Leverage variables like customer names, product details, and custom data fields to create tailored print templates. Use customer data such as tags, lifetime value, or order history to segment audiences and personalize content like thank-you notes, promotional messages, or order-specific details directly on printed materials. Highlight VIP offers for high-value customers or promote repeat purchases for first-time buyers.
Enhanced Order Fulfillment
Streamline your fulfillment process by printing personalized inserts automatically when orders are marked as fulfilled in Shopify, ensuring a streamlined process. Include customer notes, requested shipping details, or product-specific instructions to enhance the customer experience.
Comprehensive Data Utilization
Access and utilize enriched Shopify data, such as line item attributes and custom meta fields, to create detailed and context-aware print campaigns. Examples include gift messages, product bundles, and customized upsell opportunities.
Implementation Steps
1. Connect Shopify to Yuzu
Log in to your Yuzu dashboard.
Navigate to the Apps section and select Shopify.
Follow the prompts to authenticate your Shopify store.
2. Configure Data Sync
Ensure all relevant fields (e.g., metafields, tags) are active in your Shopify admin.
Verify that the correct data is pulling through to Yuzu.
Troubleshooting Tips
Missing Data:
Check that all required fields are active in your Shopify store.
Re-sync the app in the Yuzu dashboard if data is missing.
Printing Issues:
Ensure the correct template and printer are assigned in Yuzu.
Refer to the Troubleshooting Printing Guide for help.
Custom Fields Not Syncing:
Verify meta fields and tags are correctly configured in Shopify.
Contact Yuzu support for assistance with API integrations.
With Shopify integrated into Yuzu, you can automate personalized printing workflows and create highly tailored campaigns. For more advanced features or troubleshooting, reach out via our live chat.