Help Center

Frequently Asked Questions

Everything about the Shopify SimplyPrint integration. From installation to daily use.

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.

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.

Ask on GitHub