Skip to main content

Etsy Integration

Key Concepts​

The Etsy integration connects your Etsy shop to Printago for automated order processing and print-on-demand fulfillment. New orders arrive in Printago within seconds of payment (Etsy notifies Printago the moment an order is paid), and Printago matches each order's SKU to your product definitions to generate the correct print jobs automatically. Like the Shopify integration, this bridges e-commerce and production so you don't have to manually translate customer orders into print queue entries. The Etsy addon supports SKU variant mapping, so a single Etsy listing with multiple options (color, size, personalization) can automatically produce the right parts with the right materials and parameters.

Etsy Addon Info

Overview​

The Etsy addon automatically syncs your Etsy orders to Printago, enabling streamlined fulfillment for print-on-demand products. Orders arrive in real time, keeping your queue up to date the moment customers pay.

Free During Public Beta

The Etsy addon is currently free during the public beta period.

Getting Started​

1. Activate the Addon​

Navigate to Addons → Etsy and click "Activate Free During Beta" (or "Go to Addon" if already activated).

2. Connect Your Etsy Shop​

Click the connect button to authenticate with Etsy using secure OAuth 2.0. You'll be redirected to Etsy to authorize Printago to access your shop.

Etsy Sync Dashboard

3. Verify Connection​

Once connected, you'll see:

  • Your Etsy shop name
  • Connection status (green checkmark)
  • Last order sync time

Features​

Real-Time Order Sync​

Etsy notifies Printago the moment an order is paid, shipped, delivered, or canceled, so orders from your Etsy shop appear in Printago within seconds with no polling delay. Status changes flow through automatically too: orders close when shipped or delivered (based on your auto-close setting) and cancel when the sale is canceled on Etsy.

Synced orders appear in your Orders page with the Etsy logo in the Source column:

Orders Page with Etsy Source

Manual Sync​

Click "Fetch Orders Now" to manually trigger a full order sync at any time. This is useful as a catch-up if your shop was connected after orders came in, and it also re-checks the status of existing open orders.

Sync Behavior​

  • Only open orders (not yet shipped) are synced by default
  • Orders are matched to your Printago SKUs based on Etsy product variations
  • Each order item creates a job in your print queue
  • Order status updates automatically as jobs are completed

Personalization​

Etsy listings can ask buyers up to five personalization questions (text answers, dropdown choices, and file uploads). Printago understands all of them:

  • Text answers are stored on the order item under the question's text. When you import a listing's SKUs, each text question becomes a personalization variant named after the question, ready to map to a part parameter (for example, an engraving text input).
  • Dropdown ("list of options") questions import as personalization variants that carry every choice you offer on Etsy as a value. You can map each value exactly like a regular variant value: give it a text value for a part parameter, or assign a filament so a buyer choosing "Black" prints in the material you pick. The buyer's selection resolves through those mappings automatically at build time, and any value you haven't mapped falls back to passing the choice's text straight to the part.
  • Questions that share a name with one of your existing variants reuse that variant instead of creating a duplicate, whether it was created as a regular variant or a personalization. A dropdown question adds any choices the variant doesn't have yet as new values; everything already wired to the variant (materials, part parameters) keeps working. Only a question that matches nothing in your store creates a new personalization variant.
  • Optional questions stay optional. A question you haven't marked required on Etsy is attached to the SKU as an optional variant, so an order where the buyer left it blank reconciles normally. Required questions and regular variations are required on the SKU. You can change this per SKU with the Optional checkbox next to each variant on the SKU page.
  • Typed answers are matched to the variant's values. If a free-text question shares a name with a variant that has values (say "Color" with Red and Blue), an answer of "red" is treated exactly like choosing Red and drives the same material and parameter mappings. An answer that matches none of the values stops the order in reconciliation as an unknown value for you to resolve, rather than silently printing without the mapping. The import preview flags these listings so you can switch the question to a dropdown.
  • File uploads from buyers (images, PDFs, and any other type your listing accepts) are downloaded into Printago automatically when the order arrives and attached to the order item. A part whose file slot name matches the question text picks the file up at build time.
  • Listings still using Etsy's older single "Personalization" field keep working exactly as before.

Etsy → Printago: SKU Mapping​

The Etsy → Printago tab shows all your Etsy listings and helps you map Etsy product variations to Printago SKUs.

Etsy to Printago Tab

Key Information:

  • Total unique SKUs across all listings
  • Number of variation values (e.g., size/color options)
  • How many SKUs are already imported vs. need to be imported
  • Filter by shop section or SKU status
  • Sort by title, ID, or number of SKUs

Actions:

  • Click "Refresh All Listings" to fetch the latest listings from Etsy
  • Select listings to batch import SKUs
  • Use the search bar to find specific products
  • Filter by section to focus on specific product categories
  • Click individual listings to expand and see variation and personalization details

Listings that ask personalization questions are flagged in the list. Expanding one shows each question, its type, whether it is required, and the exact choices you offer on Etsy for dropdown questions.

Before the import runs, the confirmation window previews everything it will create: the variations pulled from your listing options, a variant for each text or dropdown question (dropdown choices come across as that variant's values), and the file slot names that upload questions need. Each question is labeled as reusing an existing option or creating a new option, and reused dropdowns list exactly which choices will be added as values. If a free-text question is about to reuse a variant you created yourself, the preview shows a warning: buyer answers won't be limited to that variant's values, so check its material and parameter mappings (or rename the variant or the question) before importing. Give a part a file slot with the same name as the upload question and buyer files attach themselves at build time.

The preview matches listing variations against your existing variants by name and by alias, so a listing's "Color 1" binds to your "Color" variant (shown as "Color 1 → Color") instead of creating a duplicate. For a variation that matches nothing, the preview offers a choice: create it as a new variant, or record its name as an alias of one of your existing variants and bind to that instead. Individual values resolve through value aliases the same way: a listing offering "Navy Blue" reuses your existing "Navy" value (shown as "Navy Blue → Navy") rather than adding a duplicate.

Printago → Etsy: Create Draft Listings​

The Printago → Etsy tab shows Printago SKUs that don't exist in your Etsy shop yet.

Printago to Etsy Tab

Features:

  • View all SKUs that exist in Printago but not in Etsy
  • Select SKUs to create draft Etsy listings
  • "Create Etsy Listings" button generates draft listings on Etsy
  • Listings are created as drafts, giving you a chance to review and customize before publishing

Etsy → Shopify CSV: Store Migration​

The Etsy → Shopify CSV tab helps you migrate your Etsy products to Shopify.

Etsy to Shopify CSV Tab

How it works:

  1. Select an Etsy section (or "All Sections")
  2. Choose a Shopify product category from the taxonomy
  3. Click "Export to CSV" to download a Shopify-compatible CSV file
  4. Import the CSV into Shopify to migrate your products

Features:

  • Search categories to quickly find the right classification
  • Navigate through nested category hierarchies
  • Optional "Suggest Category" button to auto-suggest based on your products

Order Management​

Viewing Etsy Orders​

Etsy orders appear in your main Orders page with:

  • Etsy order number
  • Customer information (can be hidden for privacy)
  • Number of items
  • Job status (queued, in progress, done, cancelled)
  • Creation timestamp
  • Etsy logo in the Source column

Order Workflow​

  1. Order synced from Etsy → Appears in Orders page
  2. Jobs created → Each order item becomes a job in your queue
  3. Jobs printed → Mark jobs as complete as you fulfill them
  4. Order completed → All jobs done, ready to ship
  5. Shipped → When Etsy reports the shipment (usually when the label is created), the order shows a Shipped pill on the Orders page. Until then, open Etsy orders read Unshipped.
  6. Delivered → When Etsy reports delivery, the order closes automatically (based on your auto-close setting).

Settings & Management​

The Etsy add-on's Settings tab holds the order settings for the selected shop.

Automatically Print Orders​

When enabled, new orders from Etsy are automatically added to the print queue. Order items with SKU errors are skipped. Off by default.

Auto-close Orders​

Controls when Printago closes an order based on its Etsy status:

  • When closed or shipped: close the order once Etsy reports it shipped
  • When delivered: close the order once Etsy reports it delivered (the default)
  • Never: do not auto-close

Ignored Variant Names​

Some Etsy variation options may not affect your 3D printed product. The Ignored variant names setting lets you exclude specific variation option names from SKU matching so they don't interfere with order resolution.

Ignored variants are still stored on each order item for reference — they just aren't used when Printago resolves which SKU variant to print.

  • Type the variation option name in the input field and click Add
  • Remove a name by clicking the × on its tag
  • Names match the Etsy variation option name ignoring capitalization and extra spaces

Example: If your product incorporates wood parts and your Etsy listing has Color and Wood Type variations, but the Wood Type doesn't affect your 3D printed parts, add Wood Type to the ignored list. Printago will match orders using only the Color variation.

Subscription Management​

Click "Manage Subscription" to:

  • View usage statistics (orders synced this month)
  • Update billing information
  • Manage your subscription

Quick Actions​

  • Copy Store Link - Copy your Etsy shop URL to clipboard
  • Etsy Listings - Quick link to view your listings on Etsy
  • Etsy Orders - Quick link to view orders on Etsy
  • Disconnect - Remove the Etsy integration

Tips & Best Practices​

SKU Management​

  • Import all your Etsy listing SKUs before your first order sync
  • Keep SKU names consistent between Etsy and Printago
  • Use the filter options to identify missing SKUs
  • Regularly refresh listings to catch new products

Order Processing​

  • Enable the Source column in Orders to easily identify Etsy orders
  • Check order sync status before printing to ensure you have latest updates
  • Use bulk actions to process multiple Etsy orders at once

Migration to Shopify​

  • Export one section at a time for better organization
  • Review and test CSV imports on a development Shopify store first
  • Use accurate category mappings to improve product discoverability

Troubleshooting​

Orders Not Syncing​

  1. Check your connection status in the Sync tab
  2. Verify your subscription is active
  3. Try manual sync with "Fetch Orders Now"
  4. Check that orders are marked as "Open" in Etsy

SKU Mismatches​

  1. Go to Etsy → Printago tab
  2. Search for the product listing
  3. Verify the SKU exists in both systems
  4. Check that variation names match your variants (or their aliases), and variation values match your variant values (or their value aliases)
  5. Re-import the listing if needed

Connection Issues​

If you see "Disconnected":

  1. Click the connect button to re-authenticate
  2. Ensure you're logged into the correct Etsy account
  3. Check that you've granted all necessary permissions
  4. Contact support if issues persist

Support​

Need help with your Etsy integration?

Technical Details​

OAuth 2.0 Authentication​

Printago uses industry-standard OAuth 2.0 to securely connect to your Etsy shop. We never store your Etsy password.

Sync Frequency​

  • Real time: Etsy webhooks deliver paid, shipped, delivered, and canceled order events within seconds
  • Backstop: A full sync also runs automatically every 3 hours to catch anything a webhook missed (orders are never imported twice)
  • Manual: On-demand full sync via "Fetch Orders Now"

Data Privacy​

Customer information is handled according to Etsy's API terms of service and Printago's privacy policy. You can hide the customer column in the Orders view for additional privacy.

The term 'Etsy' is a trademark of Etsy, Inc. This application uses Etsy's API but is not endorsed or certified by Etsy.