Frequently Asked Questions
Everything about the Shopify SimplyPrint integration. From installation to daily use.
Others also search for this
What is Shopify2SimplyPrint?
Shopify2SimplyPrint connects Shopify to SimplyPrint and automatically creates print jobs for every paid order. No more manual work.
How long does setup take?
About 15-20 minutes to connect your SimplyPrint account and map your products to print files. Use Auto-Map by EAN to speed things up.
What does it cost?
Free and open source under the GPLv3. No plans, no limits, no subscription. You host it on your own Cloudflare account.
Getting Started
Shopify2SimplyPrint is a Shopify app that automatically creates print jobs in SimplyPrint for every paid Shopify order. Once installed, you connect your SimplyPrint account, map your products to print files, and Shopify2SimplyPrint takes care of the rest. Every time a customer places an order in your Shopify store, a print job is automatically created in your SimplyPrint queue — with the right file, settings, and quantity.
Shopify2SimplyPrint is self-hosted rather than listed on the Shopify App Store. You deploy it to your own Cloudflare account with the one-click Deploy button, then install it on your store from the Shopify Partner Dashboard. After installation, you'll be guided through the setup:
- Connect your SimplyPrint account using your API key
- Map your Shopify products to the correct print files in SimplyPrint
The full setup takes about 15-20 minutes.
You need:
- An active Shopify store (any plan)
- A SimplyPrint account
- At least one product in Shopify that corresponds to a print file in SimplyPrint
No technical knowledge is required — the setup is guided step by step.
Most users complete the initial setup in 15-20 minutes. This includes connecting your SimplyPrint account, mapping your first products to print files, and placing a test order to confirm everything works. If you have many products to map, you can use the Auto-Map by EAN feature to speed things up.
Simple mode always creates a print job in SimplyPrint when a paid Shopify order comes in.
Advanced mode is for businesses that keep stock: it only creates a print job when the product's inventory in Shopify drops below a configured threshold.
Most shops start with Simple mode.
Print Job Sync
When a customer completes a payment in your Shopify store, Shopify2SimplyPrint receives a webhook notification. It looks up which print file in SimplyPrint corresponds to the ordered product (based on your product mapping), and creates a print job with the correct file, quantity, and settings. This happens automatically within minutes of the order being placed.
In the Shopify2SimplyPrint dashboard, go to the Products page. There you'll see all your Shopify products listed. For each product (or variant), you can select the corresponding file from your SimplyPrint library.
Alternatively, you can use Auto-Map by EAN: if your SimplyPrint file names contain the product's barcode/EAN, Shopify2SimplyPrint maps them automatically.
Auto-Map by EAN is a feature that automatically maps your Shopify products to SimplyPrint files based on the product barcode (EAN/UPC). If your print files in SimplyPrint have names that include the product barcode (e.g., dragon-figurine-1234567890.stl where 1234567890 is the EAN), Shopify2SimplyPrint will detect this and map the product automatically — no manual mapping needed.
Yield per print tells Shopify2SimplyPrint how many units of a product come from a single print job. For example, if you can print 4 keychains on one print plate, set yield to 4. When an order comes in for 8 keychains, Shopify2SimplyPrint will create 2 print jobs (8 ÷ 4 = 2) instead of 8. This saves print time and material.
Yes! If you sell the same product in different colors (e.g., a planter in Gold, Silver, Black), Shopify2SimplyPrint can automatically detect the color from your Shopify variant name and pass it as a material tag to the SimplyPrint queue. This way your print operators see which filament to load at a glance.
To enable this, go to Settings > Queue Settings and check "Enable filament color". Once enabled, a Color column appears on the Products page where you can review or override the auto-detected colors.
If an ordered product has no print file mapping in Shopify2SimplyPrint, no print job is created. The order is logged in your Sync Logs with a "no mapping found" status. No error is shown to the customer, and the order remains in Shopify as normal. You can then map the product and manually trigger a sync if needed.
Order Status
This feature is on the roadmap. Currently, Shopify2SimplyPrint focuses on the order-to-print-job direction: from Shopify to SimplyPrint. Automatic fulfillment status sync (marking a Shopify order fulfilled when the print job completes in SimplyPrint) will be added in a future update.
The Queue History page in Shopify2SimplyPrint shows all orders that have been processed. You can see the order number, product, print job status, and any errors. The Sync Logs page provides a more detailed technical log of every sync attempt.
Sync Logs are a detailed record of every sync operation Shopify2SimplyPrint has performed. For each log entry, you can see the timestamp, which order was processed, what action was taken, and whether it succeeded or failed. If something goes wrong, the log entry includes an error message explaining what happened, so you can diagnose and fix the issue.
Cost and licensing
Nothing is paid to us. Shopify2SimplyPrint is free and open source under the GPLv3, with no plans, limits or subscription.
You run it in your own Cloudflare account, so the only possible cost is Cloudflare's. For typical shop volumes that fits inside their free tier.
No. There is no account and no hosted service to sign up for. You deploy the app yourself, and it talks directly to your Shopify store and your SimplyPrint account.
No. Every feature is included: unlimited print jobs, both Simple and Advanced mode, multi-file mappings, and auto-mapping by EAN.
This used to be a paid Shopify app called SimplyPrintSync. It is now open source, and the billing, print limits and subscription tiers have been removed entirely. If you self-host it, everything is unlocked.
The hosted service has been discontinued, so there are no subscriptions left to manage.
Troubleshooting
If Shopify2SimplyPrint can't create a print job for an order (for example, because of a SimplyPrint API error), it logs the failure in your Sync Logs with an error message. No print job is created, and no change is made to the Shopify order. You can review the error, fix the underlying issue, and manually retry the sync from the Queue History page.
The most common reasons are:
- The product isn't mapped to a print file in Shopify2SimplyPrint — go to the Products page and add the mapping.
- You're on Simple mode and the order status wasn't "paid" — Shopify2SimplyPrint only triggers on paid orders.
- Your SimplyPrint connection has expired — check the Dashboard for your connection status and re-enter your API key if needed.
On the Shopify2SimplyPrint Dashboard, there is a Connection Status card that shows whether your SimplyPrint account is connected. If it shows a red or warning status, your API key may have expired or been revoked. Go to Settings and re-enter your SimplyPrint API key.
First, check that you're using the correct API key. You can find your SimplyPrint API key in your SimplyPrint profile settings. Make sure you copy the full key without any extra spaces. If the problem persists after re-entering the key, contact us via WhatsApp or email and we'll help you resolve it.
Question not listed?
Ask on GitHub, where everyone running it can see the answer.