Print Connector is Coming Soon
We're developing a powerful browser extension and printing system to bridge the gap between your digital orders and physical shipments.
Overview
The Podmaster Print Connector is a Chrome/Edge browser extension that connects directly to your Podmaster account via API. It provides a convenient popup interface to:
- Browse orders — Paginated list of all paid orders with search
- View order details — Customer info, line items, design thumbnails
- Print orders — Print order summaries and design details using your browser's print dialog
Print Profiles (configured in the app) define paper size, orientation, margins, design placement, and color mode (RGB or CMYK) for your print output.
Prerequisites
- Google Chrome or Microsoft Edge (Chromium-based) browser
- Your Podmaster API Key (found in Settings → API Settings)
- Your Shop ID (your Shopify store domain, e.g.,
mystore.myshopify.com)
Installing the Extension
Step 1: Get the Extension Files
Download or obtain the chrome-ext folder from your Podmaster installation. Place it in a permanent location on your computer, for example:
C:\PODMaster\chrome-ext\Step 2: Load the Extension in Chrome
- Open Chrome and navigate to
chrome://extensions/ - Enable Developer mode using the toggle in the top-right corner
- Click Load unpacked
- Select the
chrome-extfolder - The extension will appear as "Podmaster Print Connector"
edge://extensions/ instead and follow the same steps.
Step 3: Configure the Extension
On first install, the settings page opens automatically. You can also access it by clicking the extension icon and then the gear icon, or right-clicking the extension → Options.
- App URL — Enter your Podmaster application URL (e.g.,
https://yourapp.com) - Shop ID — Enter your Shopify store domain (e.g.,
mystore.myshopify.com) - API Key — Enter your Podmaster API key (found in Settings → API Settings in the app)
- Click Test Connection to verify everything works
- Click Save Settings
Using the Extension
Browsing Orders
Click the extension icon to open the popup. You'll see a list of all paid orders, sorted by most recent first. Each order card shows:
- Order number and total price
- Customer name and order date
- Payment and fulfillment status badges
- Number of line items
Use the search bar to filter orders by order number, customer name, or email. Click Prev/Next buttons to navigate between pages.
Viewing Order Details
Click any order card to see its full details:
- Order Information — Order number, date, status, and total
- Customer — Name, email, phone
- Shipping — Shipping method and cost
- Items — Each line item with product name, variant, quantity, price, and design thumbnails
Printing Orders
There are two ways to print from the extension:
Print Individual Item Designs
In the order detail view, click the Print Design button on any line item. This opens a new tab showing the design files for that item, then automatically opens the browser print dialog.
Print Order Summary
Click the Print Order Summary button at the bottom of the order detail view. This opens a new tab with a formatted order overview including customer info, all line items, and order totals.
window.print()). You can choose your printer, paper size, and other settings directly in the dialog.
Configuring Print Profiles
Print profiles are configured in the Podmaster app under Settings → Print Profiles. They define how your designs should be formatted for printing.
Creating a Print Profile
- Go to Settings → Print Profiles in the Podmaster app
- Click Add Print Profile
- Fill in the profile details
| Field | Description |
|---|---|
| Profile Name * | A descriptive name, e.g., "A4 Portrait - Mug Prints" |
| Set as Default | Check this to make it the default profile for new orders |
| Description | Optional notes about when to use this profile |
| Print Width / Height | Paper dimensions in centimeters (e.g., 21.0 × 29.7 for A4) |
| Orientation | Portrait or Landscape |
| Margins | Top, right, bottom, left margins in centimeters |
| Design Width * | Width of the design area in centimeters |
| Design Position * | Where to place the design on the page (9 positions available) |
| Color Model | RGB or CMYK — see below |
| Print Device | Your printer name for reference |
Fields marked with * are required.
Color Model: RGB vs CMYK
- RGB — Best for digital printing: T-shirts, canvas prints, wall art, pillow cases, rugs, doormats
- CMYK — Best for commercial offset printing: business cards, brochures, packaging, stickers
When CMYK is selected, choose an ICC Profile that matches your printing process:
| ICC Profile | Best For |
|---|---|
| USWebCoatedSWOP | US commercial offset printing |
| PSO Coated v3 — Glossy | European offset with glossy laminate |
| PSO Coated v3 — Matte | European offset with matte laminate |
| PSO Uncoated v3 (FOGRA52) | Uncoated paper printing |
| JR G7 | G7-certified proofing and printing |
| Metal Printing (FOGRA60) | Metal and specialty substrate printing |
Testing a Print Profile
- In the profile list, click the Test button
- Review the print configuration and visual preview
- Click Print Test Page to open a test page in a new browser tab
- The browser print dialog opens automatically with the correct page size and margins
- Verify the output matches your expectations
API Reference
The extension uses these Podmaster API endpoints:
| Endpoint | Description |
|---|---|
GET /api/podmaster/{shop_id}/orders | List orders with pagination. Params: page, limit, start_date, end_date |
GET /api/podmaster/{shop_id}/orders/{id} | Get single order with line items and design data |
GET /api/podmaster/{shop_id}/print-profiles | List all print profiles for the shop |
GET /api/podmaster/{shop_id}/print-profiles/{id} | Get a single print profile |
All endpoints require the pod-api-key header for authentication.
Troubleshooting
"Extension not configured" message
- Click the gear icon in the popup header to open settings
- Enter your App URL, Shop ID, and API Key
- Use the Test Connection button to verify
Orders not loading
- Verify your API key is correct (check Settings → API Settings in Podmaster)
- Ensure the App URL includes the protocol (e.g.,
https://) - Check that the Shop ID matches your Shopify domain exactly
- Try the Test Connection button in the extension settings
Design images not showing
- Design images are served from your CDN/CloudFront. Ensure the
CLOUDFRONT_DOMAINis configured in your Podmaster.envfile - Check that the order has customized products with saved designs
Print dialog not opening
- Make sure pop-ups are allowed for the extension
- Try clicking the "Print" button in the print preview tab manually