How to Use Etsy Orders Sync
Complete guide to set up and use our system to manage your Etsy orders efficiently with multi-provider fulfillment integration.
Shop owner? Team & permissions
Owner guide: staff accounts, shop teams, role matrix (MANAGER / FULFILLER / VIEWER), and Settings workflow.
Orders flow from Etsy → Extension captures → Dashboard manages → Fulfillment processes
Quick Start Guide
Get started with Etsy Orders Sync in just 4 simple steps:
Activate with License Key
Open the extension popup and enter your license key from the dashboard.
- Go to License page in your dashboard
- Copy your license key
- Paste into extension and click "Connect"
Start Syncing Orders
Navigate to Etsy orders page and sync your orders with one click.
- Go to etsy.com/your/orders
- Click extension icon
- Click "Sync Orders Now"
Chrome Extension
The Chrome extension is your gateway to automatically capture orders from Etsy and sync them to your dashboard or Google Sheets.
Auto-Detection
Automatically detects when you're on Etsy orders page and extracts order data.
One-Click Sync
Sync all visible orders with a single click. Smart caching prevents duplicates.
Multi-Shop Support
Manage multiple Etsy shops from the same extension installation.
Dual Destinations
Choose to sync to Web Dashboard, Google Sheets, or both at once.
How to Use the Extension
- 1Navigate to etsy.com/your/orders
- 2Click the extension icon in your Chrome toolbar
- 3Select sync destination: Web, Sheet, or Both
- 4Click "Sync Orders Now" and wait for completion
Web Dashboard
Your central hub for managing orders, shops, customers, designs, and fulfillment. The sidebar gives quick access to Dashboard, Analytics, Orders, Shops, Customers, Designs, and more.
Dashboard Home
Summary stats, recent orders, top shops, license status, and customer geo overview.
Order Management
View, filter, search, and manage all orders in one place.
Shop Management
Connect and configure multiple Etsy shops and fulfillment providers.
Analytics Page
Deeper insights on trends, shops, fulfillment, staff, products, and customers — see the Analytics section below.
Analytics
The Analytics page provides detailed performance insights across your shops and team. Use filters at the top to scope data by shop, date range, and other criteria.
Overview
KPI highlights: order volume, revenue, fulfillment rates, and key trends at a glance.
Trends
Time-series charts showing how orders and revenue change over your selected period.
Shop Performance
Compare metrics across shops to see which stores perform best.
Fulfillment Breakdown
Orders grouped by provider (Lenful, Merchize, MangoTeePrints, BurgerPrints, Manual) and fulfillment status.
Staff Performance
Track team activity and fulfillment output per staff member.
Product Performance
See which products drive the most orders and revenue.
Customer Insights
Repeat vs one-time buyers, geographic distribution, and customer mix in the selected period.
Export
Export analytics data as CSV. Exports respect your current filters.
Access notes
VIEWER accounts have read-only access to orders only. ROOT/ADMIN system roles can view system-wide analytics in read-only mode.
Shop Management
Manage your Etsy shops and connect them to fulfillment providers.
What You Can Do:
- Add new shops manually or via extension
- Configure Google Sheets integration per shop
- Connect shops to Lenful, Merchize, MangoTeePrints, or BurgerPrints
- Enable MangoTeePrints fulfillment per shop (toggle on shop card)
- Connect BurgerPrints with a per-shop API key (no global Settings config)
- Assign shops to staff members via Team dialog
- View order statistics per shop
- Set Merchize Shop ID per shop
Order Management
Full control over your orders with powerful filtering, bulk actions, fulfillment sync, and activity tracking.
Advanced Filters
Filter by shop, date range, fulfillment status, tracking, or search by order ID and customer.
Order Details
View complete order info including products, shipping, personalization, and fulfillment state.
Export Data
Export orders as CSV for custom reporting and analysis.
Fulfillment & Bulk Actions
Sync to fulfillment providers, bulk update/delete, and manage multiple orders at once.
Manual Fulfillment
For orders fulfilled outside the system, add manual tracking numbers directly from the Orders page.
Activity Log
View per-order audit history: sync events, status changes, and internal notes.
Fulfillment Integration
Connect with fulfillment providers to automate order processing. We support Lenful, Merchize, MangoTeePrints, and BurgerPrints, plus Manual tracking for external fulfillment.
Lenful
Print on demand and embroidery fulfillment service. Requires API Token and Store URL.
Merchize
Print on demand fulfillment service. Requires Access Token and Shop ID per shop.
MangoTeePrints
Print on demand fulfillment. Requires API key in Settings and per-shop enable toggle.
BurgerPrints
Print on demand fulfillment. API key is configured per shop (not in global Settings).
Manual
Track orders fulfilled outside any integrated provider by adding manual tracking from Orders.
Setting Up Lenful
- 1Go to Settings page in your dashboard
- 2Enter your Lenful API Token and Store URL
- 3Click Save Configuration
- 4Go to Shops and click "Sync to Lenful" on each shop
- 5Now you can sync orders to Lenful fulfillment from the Orders page!
Setting Up Merchize
- 1Log in to your Merchize Seller account, then go to Integrations → API
- 2Copy your Access Token from the ACCESS TOKEN tab
- 3Copy your Shop ID from the BASE URL — it's the segment after the domain, e.g.
5d5gzi0fromhttps://bo-group-1-2.merchize.com/5d5gzi0/bo-api - 4Go to Settings in your dashboard and paste the Access Token in the Merchize configuration section, then click Save Configuration
- 5Go to Shops page, click "Sync to Merchize" on each shop, and enter the Shop ID you copied from step 3
- 6Now you can sync orders to Merchize fulfillment from the Orders page!
Important Notes (Merchize)
- Merchize Access Token is shared across all shops (configured once in Settings)
- Merchize Shop ID is unique per shop (configured per shop when syncing)
Setting Up MangoTeePrints
- 1Go to Settings and enter your MangoTeePrints API key
- 2Click Save Configuration
- 3On the Shops page, enable MangoTeePrints fulfillment toggle for each shop you want to sync
- 4Staff can use the owner's API key or configure their own in Settings
- 5Sync orders from the Orders page — select production line, shipping method, print areas, and designs
Setting Up BurgerPrints
- 1On the Shops page, click "Connect to BurgerPrints" on the shop card
- 2Enter your BurgerPrints API key and choose sandbox mode if testing
- 3Each shop has its own API key — there is no global BurgerPrints config in Settings
- 4Sync orders from the Orders page — map catalog SKU, print areas, and designs
- 5Use Re-connect BurgerPrints on the shop card to update credentials
Manual Fulfillment
- 1For orders fulfilled outside Lenful, Merchize, MangoTeePrints, or BurgerPrints
- 2Open the order on the Orders page and use Add manual tracking
- 3Enter carrier and tracking number — useful for self-fulfilled or third-party orders
- 4Bulk manual fulfill is available when selecting multiple orders
Important Notes
- MangoTeePrints API key is per-user in Settings; enable per-shop on the Shops page
- BurgerPrints API key is per-shop only — configure on each shop card
- Each user/staff member can configure their own API tokens where supported
Syncing Orders to Fulfillment
- 1Go to the Orders page and select one or more orders
- 2Click the "Sync to Fulfillment" action or expand an order row
- 3Select the configured provider (Lenful, Merchize, MangoTeePrints, or BurgerPrints)
- 4Review order details, map products, choose saved designs or upload new ones
- 5Click "Sync" to submit the order to the fulfillment provider
Customers
The Customers page shows buyers extracted from your synced orders. Data is built automatically — no manual import needed.
Customer List
Browse customers with order counts, shop links, and contact info. Filter by shop to focus on one store.
Geographic Insights
Interactive globe and country stats show where your customers are located.
Summary Stats
Total customers, orders per customer, and repeat-buyer metrics at a glance.
Staff & Privacy
Staff see customers only from shops they belong to. Sensitive PII may be masked based on shop role — see the owner guide for capability settings.
Designs Library
Save and reuse product design templates across fulfillment syncs. Designs are linked to a provider and product so you can pick them quickly when syncing orders.
Save During Sync
When syncing an order to fulfillment, enable "Save this design" to store files, mockups, and Design SKU in your library.
Browse & Search
Filter designs by provider or product. Search by Design SKU or name on the Designs page.
Reuse in Fulfillment
In any fulfillment sync modal, switch to the "Saved designs" tab to pick a template instead of re-uploading files.
Staff Permissions
The <code>manageDesigns</code> capability controls whether staff can create, edit, and delete designs or only view them. Configure in Settings → role matrix.
Google Sheets Integration
Export orders directly to Google Sheets for custom reporting and backup.
Setup Steps:
- 1Create a new Google Apps Script at script.google.com
- 2Download the template from this Google Sheets template
- 3Deploy as Web App (Execute as: Me, Access: Anyone)
- 4Copy the deployment URL
- 5Paste the URL in your shop settings on the dashboard
Staff Management
Invite team members to help manage shops with role-based permissions. For full setup (accounts, shop teams, capability matrix), see the owner guide.
Two-Level Permissions
System role STAFF + shop membership role (MANAGER / FULFILLER / VIEWER). Actual capabilities are defined in Settings → role matrix.
How Staff Access Works:
Typical Staff Can:
- • View orders, customers, and designs for assigned shops
- • Fulfill and sync orders (if FULFILLER role + capability enabled)
- • Export orders and manage designs (per capability matrix)
- • View dashboard and analytics for assigned shops
Typically Cannot (unless enabled in matrix):
- • Add or delete shops (owner only)
- • Change global Settings or license (owner only)
- • Create staff accounts (owner only)
- • Access unassigned shops
Need the full setup guide?
Shop owners should follow the owner guide for staff accounts, shop teams, and the capability matrix.
Troubleshooting
- Make sure you're on etsy.com/your/orders
- Verify you're logged into your Etsy account
- Refresh the page and try again
- Check if the extension is enabled in Chrome
- Check your internet connection
- Verify your license key is valid and active
- Make sure the shop is linked to your account
- Try logging out and back into the dashboard
- Verify the Google Apps Script URL is correct
- Check Google Apps Script execution logs for errors
- Ensure the script is deployed as 'Web App' with 'Anyone' access
- Re-deploy the script if you made changes
- Check Lenful API configuration in Settings
- Verify shop is connected to Lenful (Shops page)
- Ensure product mapping is correct
- Check your Lenful account status and balance
- Check Merchize Access Token in Settings page
- Verify shop has a correct Merchize Shop ID configured (Shops page)
- Go to seller.merchize.com/a/integrations/api and confirm your token is still valid
- Make sure the BASE URI format is correct: https://bo-group-1-2.merchize.com/{shop_id}/bo-api
- Ensure product SKU mapping is correct when syncing orders
- Check your Merchize account balance and status
- Check MangoTeePrints API key in Settings → MangoTeePrints section
- Enable MangoTeePrints fulfillment toggle on the shop card (Shops page)
- Staff must have syncToProvider capability and a valid API key (own or owner's)
- Verify production line and shipping method are selected in the sync modal
- Re-save API key if MangoTeePrints rejected the token
- Verify BurgerPrints API key on the shop card (per-shop, not in Settings)
- Use Re-connect BurgerPrints if you rotated the API key
- Check sandbox mode matches your BurgerPrints environment
- Ensure catalog SKU and required print-area designs are configured per line item
- Manual fulfillment is for orders fulfilled outside integrated providers
- Use Add manual tracking on the order row or bulk manual fulfill for multiple orders
- Ensure you have fulfill permission in the capability matrix (staff)
- Refresh the page and check your date/shop filters are valid
- Ensure you have orders synced for the selected period
- Export uses current filters — narrow the date range if the file is too large
- VIEWER accounts cannot access Analytics; use an owner or staff account with broader access
Need More Help?
Our support team is ready to help you with any questions.