Troubleshooting
Quick fixes for common issues and error messages.
How to use this guide
Find your issue below, follow the steps, and you'll be back on track. If you're still stuck after trying these solutions, contact support—we're here to help.
Search tip
File upload problems
❌"File too large"
Cause: File exceeds 500MB size limit.
- Reduce polygon count in your 3D software (decimate/simplify mesh)
- Export with lower resolution settings
- Split large models into multiple parts
- Convert to binary STL instead of ASCII (smaller file size)
❌"Invalid file format"
Cause: File isn't a supported 3D model format.
- Convert to STL (most common), OBJ, 3MF, or STEP
- Ensure file extension matches actual format (.stl file must be STL, not renamed)
- Re-export from your 3D software with correct export settings
- Try uploading a different file to test if issue is file-specific
❌"Upload keeps failing/timing out"
Cause: Network issues or browser problems.
- Check your internet connection (try loading other websites)
- Try a different browser (Chrome usually works best)
- Clear browser cache and cookies
- Disable VPN or proxy if active
- Try uploading from a different network (mobile hotspot, different Wi-Fi)
⚠"File has errors (non-manifold, holes, etc.)"
Cause: 3D model has geometric issues that prevent printing.
- Use auto-repair tools: Meshmixer (free), Microsoft 3D Builder (free), or Netfabb
- In your 3D software: merge duplicate vertices, recalculate normals, make manifold
- Contact support—we can often fix files for free
Store connection problems
❌"Could not connect to Shopify/Etsy/etc."
Cause: Authorization failed or permissions missing.
Verify store URL
Ensure you entered the correct store URL (mystore.myshopify.com, not custom domain)
Check permissions
Make sure you're logged in as store owner/admin, not staff with limited access
Try again
Disconnect and reconnect following our store connection guide step-by-step
Check platform status
Visit Shopify/Etsy status pages to see if their API is down
⚠"Orders not syncing from my store"
Cause: Webhook issues or store disconnected.
- Check connection status in Settings → Integrations (should say "Connected")
- Verify products have PrintPort3D fulfillment enabled
- Test with a manual order in your store to see if it appears in dashboard
- Disconnect and reconnect store to reset webhooks
- Contact support if issue persists—we can check webhook logs
❌"Products not showing in my store"
Cause: Sync settings or product status issues.
- Verify product is set to "Published" (not Draft) in PrintPort3D dashboard
- Check sync settings—some platforms require manual publishing
- Wait 5-10 minutes for sync to complete (not instant)
- Ensure store connection is active (green dot in Integrations)
Order fulfillment issues
⚠Order stuck in "Processing" for days
Cause: Print queue backlog or technical issue.
- Check order details for any alerts or error messages
- Processing normally takes 24-48 hours; if >3 days, contact support
- Check system status page for known issues or delays
- Support can expedite if customer is waiting
❌"Manual Review Needed" status
Cause: Issue detected that requires human intervention.
- File error: Model has issues preventing slicing
- Shipping price anomaly: Label cost way higher than estimated
- Address validation failed: Incomplete or incorrect address
- Payment issue: Card declined or payment method failed
- Click order to view details and see specific issue
- Follow instructions in status detail (e.g., "update address," "approve extra cost")
- Use action buttons (Fix Address, Approve Cost, Re-upload File, etc.)
- If unclear, contact support—we'll guide you through resolution
❌"Payment failed" on order
Cause: Your payment method couldn't be charged for production costs.
- Go to Settings → Billing → Payment Methods
- Check if card is expired or has insufficient funds
- Add a new payment method or update existing one
- Order will auto-retry charging in 24 hours
- Or click "Retry Payment Now" button on order page
⚠Tracking hasn't updated in days
Cause: Carrier scanning delays or package in transit gap.
- Normal gaps are 24-48 hours between scans
- If >5 days with no update, file a tracking inquiry in dashboard
- We'll send replacement if package confirmed lost by carrier
Account & login issues
❌"Incorrect password" / Can't log in
Cause: Wrong password or account issue.
- Click "Forgot Password?" on login page to reset
- Check email (including spam folder) for reset link
- Ensure you're using correct email address
- Try logging in with Google/Facebook if you originally used social login
- Clear browser cache/cookies and try again
- If still stuck, contact support with your email—we can help verify account
❌2FA code not working
Cause: Time sync issue or wrong app.
- Ensure device time is synced (Settings → Date & Time → Auto)
- Wait for new code to generate (codes expire every 30 seconds)
- Use backup codes saved when setting up 2FA
- Contact support to disable 2FA temporarily if you've lost access
⚠Not receiving email notifications
Cause: Email settings or spam filtering.
- Check spam/junk folder for emails from @printport3d.com
- Add support@printport3d.com to contacts/safe senders
- Verify notification settings: Settings → Notifications (ensure toggled on)
- Test by sending test notification from settings page
- Check if email address is correct in profile settings
Performance & display issues
⚠Dashboard loading slowly
Cause: Browser cache, extensions, or network issues.
- Hard refresh: Ctrl+Shift+R (Windows) or Cmd+Shift+R (Mac)
- Clear browser cache and cookies
- Disable browser extensions temporarily (especially ad blockers)
- Try incognito/private browsing mode
- Switch to Chrome if using other browser
- Check internet speed (run speed test—need >5 Mbps)
❌3D viewer not loading
Cause: WebGL disabled or graphics card issue.
- Check if WebGL is enabled: visit
get.webgl.org - Update graphics drivers
- Enable hardware acceleration in browser settings
- Try different browser (Chrome has best WebGL support)
- If on laptop, ensure using dedicated GPU (not integrated)
⚠Page looks broken / formatting weird
Cause: CSS not loading or browser compatibility.
- Hard refresh page (Ctrl+Shift+R or Cmd+Shift+R)
- Clear cache completely
- Update browser to latest version
- Try different browser
- Disable browser extensions that modify pages (Grammarly, etc.)
Billing & payment issues
❌Card declined / payment failed
Cause: Bank declined transaction.
- Contact your bank—may need to approve PrintPort3D as safe merchant
- Ensure sufficient funds in account
- Verify billing address matches card on file
- Try a different card
⚠Invoice shows unexpected charges
Cause: Extra costs from add-ons, shipping upgrades, or corrections.
- Download detailed invoice from billing page
- Check line items for breakdown (material, labor, shipping, add-ons)
- Compare to original order cost estimate
- If still unclear, contact support with invoice number—we'll explain each charge
- Valid errors refunded immediately
⚠Can't remove old payment method
Cause: Can't delete card set as default or with pending charges.
- Set a different card as default first
- Ensure no pending charges on that card
- Then delete old card
- Must always have at least one payment method on file
Still need help?
If these solutions didn't resolve your issue, our support team is ready to assist:
Fastest response. Click chat widget (bottom-right) for instant help.
Submit detailed ticket from your dashboard for complex issues.
When contacting support, include:
- Description of the problem
- Steps you've already tried
- Screenshots of error messages
- Order number or product ID (if relevant)
- Browser and OS you're using