# Printago Documentation Map

This is a comprehensive map of all Printago documentation pages with their headings, designed for easy navigation by LLMs.

> **Note:** This file is auto-generated by `scripts/generate-docs-map.mjs`. Do not edit manually.
> Last updated: 2026-04-24 18:58:51 UTC

## Document Structure

This map uses a hierarchical structure:

* **##** marks documentation groups (e.g., 'Overview')
* **###** marks individual documentation pages
* **Nested bullets** show the heading structure within each page
* Each page title links to the full documentation

## Getting Started

### [quick-start-guide](https://docs.printago.io/docs)

* Before You Begin
* Step 1: Create Your Account
* Step 2: Connect Your Printers
* Step 3: Set Up Materials
  * Import Materials from AMS
  * Configure Material Slicing Profiles
* Step 4: Add Your First Part
* Step 5: Start Your First Print
* Step 6: Mark Printers Ready
* Step 7: Watch the Magic Happen
* Step 8: Complete the Workflow
* Next Steps

## Overview

### [what-is-printago](https://docs.printago.io/docs/overview/what-is-printago)

* Who is it For?
  * Print Farm Owners
  * Educational Institutions
  * Engineering Teams
  * Cottage Industry Sellers
  * Print-on-Demand Services
* Key Features
  * Zero Hardware Requirements
  * Native Customization Support
  * Intelligent Queue Management
  * Direct E-Commerce Integration
  * Powerful API
  * Flexible Pricing
* Cloud Architecture

### [key-concepts](https://docs.printago.io/docs/overview/key-concepts)

* Configure Once, Automate Forever
* Parts
* SKUs (Assemblies)
* Orders
* Print Queue & Gutenb3d
* Materials
* Slicer Profiles
* Cloud Slicer (On-Demand Slicing)
* Printer Management
* Dynamic Models (OpenSCAD)
* FabMatic Continuous Printing
* E-Commerce Integrations

### [dashboard](https://docs.printago.io/docs/overview/dashboard)

* Printer Cards
  * Card Information Display
  * Status Indicators
* Job Monitoring
  * Dashboard Actions

## Connecting Printers

### [bambu-lab-integration](https://docs.printago.io/docs/connecting-printers/bambu-lab-integration)

* Connection Mode Support
* First-Time Setup
* Authentication Expiry
* Managing Connected Printers
  * Disabling Printers
* How Printago Connects to Your Printers
* Compatible Printers
* Firmware Requirements
  * Downgrading Firmware
* Troubleshooting

### [printago-fuse](https://docs.printago.io/docs/connecting-printers/printago-fuse)

* Download
  * Desktop Applications
  * Docker
    * Quick Start
    * Docker Compose
* Prerequisites
  * Network Requirements
* Activation
  * Activation Process
* Status Dashboard
* Adding Printers
  * Adding Physical Printers
    * Method 1: Auto-Scan (Recommended)
    * Method 2: Subnet Search
    * Method 3: Add Manually
  * Adding Virtual Printers
  * Importing Configuration
* Managing Printers
  * Printer Cards
  * Printer Actions
  * Live Camera View
  * MQTT Communications
  * Virtual Printer Controls
  * Editing Printer Settings
  * Removing Printers
* Files
* Settings
  * Fuse Gateway
  * Printer Management
  * External Integrations
  * File Cache
  * Troubleshooting
  * Danger Zone
* Troubleshooting
  * Printers Not Discovered
  * Connection Issues
  * Printer Won't Connect
  * File Upload Issues
  * Camera Not Loading
* Technical Details
* Support

### [klipper-integration](https://docs.printago.io/docs/connecting-printers/klipper-integration)

* What to Expect
* Stay Updated
* Questions?

### [prusa-link](https://docs.printago.io/docs/connecting-printers/prusa-link)

* What to Expect
* Stay Updated
* Questions?

### [virtual-printers](https://docs.printago.io/docs/connecting-printers/virtual-printers)

* What You'll Learn
* What Are Virtual Printers?
* Creating a Virtual Printer
* Understanding the Virtual Printer
* Virtual Printer Controls
  * Connection Status
  * HMS Error Simulation
  * Test Print
  * Reset Printer
* Running a Test Print
* Simulating Errors

## Parts & Files

### [part-management](https://docs.printago.io/docs/parts/part-management)

* Key Concepts
* Supported Part Types
* Cross-Printer Compatibility
* Part Processing
* Adding Parts to Printago
* File-Specific Settings

### [stl-step-parts](https://docs.printago.io/docs/parts/stl-step-parts)

* Overview
* Adding STL/STEP Parts
* Material Selection
* Process Profile Override
* STL/STEP Tips

### [3mf-project-files](https://docs.printago.io/docs/parts/3mf-project-files)

* What Makes 3MF Special
* 3MF in Printago
* Sliced vs Unsliced 3MF Files
  * Unsliced 3MF Files (Recommended)
  * Sliced 3MF Files (GCODE 3MF)
* Adding 3MF Parts
* Why Use 3MF?

### [gcode-3mf-files](https://docs.printago.io/docs/parts/gcode-3mf-files)

* What Are Gcode.3mf Files?
  * Key Limitations
* When to Use gcode.3mf Files
* Adding gcode.3mf Files
* Material Remapping
* Migration to Better Formats
* Common Issues

### [openscad-intro](https://docs.printago.io/docs/parts/openscad/openscad-intro)

* What is OpenSCAD?
* Editing OpenSCAD Files
* Importing Files
* Dynamic Models
  * Parameter Types
  * Font Support
  * Parameter Dependencies
  * Conditional Features
* Best Practices
  * Modular Design
  * Performance Optimization
  * Error Handling
* Common Use Cases
  * Product Customization
  * Batch Production
  * Design Variants
* Troubleshooting
  * Rendering Issues
  * Performance Problems
* OpenSCAD Resources

### [openscad-parts](https://docs.printago.io/docs/parts/openscad/openscad-parts)

* Adding OpenSCAD Parts to Printago
* Parameter Management
  * Parameter Types and Display Rules
  * Best Practices
  * File Management

### [colorscad](https://docs.printago.io/docs/parts/openscad/colorscad)

* How It Works
* Example: Two-Color Model
* Supported Color Formats
  * 1. Named Web Colors (Quoted Strings)
  * 2. Variable Colors (Unquoted Identifiers)
* How Materials Are Extracted
* Complete Example
* Getting Started
* Commercial Benefits

### [libraries](https://docs.printago.io/docs/parts/openscad/libraries)

* General Purpose Libraries
  * BOSL (Belfry OpenSCAD Library)
  * BOSL2 (Belfry OpenSCAD Library v2)
  * dotSCAD
* Specialized Libraries
  * Gridfinity
  * KeyV2
  * Knurled Finish Library
  * MCAD (OpenSCAD Mechanical CAD Library)
  * NopSCADlib
* Usage in Printago
  * Including Libraries
  * Library-Specific Examples
    * BOSL2 Example
    * Gridfinity Example
* Best Practices
  * Performance Considerations
  * Version Compatibility
  * Documentation
* Support

### [cadquery-intro](https://docs.printago.io/docs/parts/cadquery/cadquery-intro)

* What are CadQuery and build123d?
* How Scripts Work
  * CadQuery Example
  * build123d Example
  * Parameters
  * Parameter UI Hints (printago dict)
  * Multi-Color Assemblies
    * CadQuery
    * build123d
    * How Colors Are Processed
    * Supported Color Formats
* Execution Environment
* Local Development
  * Setup
  * Viewing Models
  * Exporting STL Locally
* Best Practices
  * Script Structure
  * Performance
  * 3D Printing Considerations
* Using Existing CadQuery Scripts
* Resources

### [libraries](https://docs.printago.io/docs/parts/cadquery/libraries)

* Core CAD Libraries
  * CadQuery
  * build123d
* Part Libraries
  * bdwarehouse
* Geometry & Math Libraries
  * NumPy
  * SciPy
  * Shapely
* SVG & File Import
  * svgpathtools
* Mesh & STL Libraries
  * trimesh
  * numpy-stl
* Standard Library
* Example: Using Libraries Together
* Requesting Additional Libraries

## Printing

### [printing-parts](https://docs.printago.io/docs/printing/printing-parts)

* Key Concepts
* Starting a Print
  * Single Part Printing
  * Queue Priority Options
  * STL Parts
  * 3MF Files
  * OpenSCAD Parts (.scad)
  * Bulk Printing
* Printer Assignment
  * Assignment Methods
    * Next Available
    * Specific Printer
    * Tagged Printers
  * State Diagram
* Next Steps

### [print-queue](https://docs.printago.io/docs/printing/print-queue)

* Key Concepts
* Understanding the Queue Interface
  * Job Interaction
  * Why Jobs Wait in Queue
  * In-Progress Jobs
  * Job Outcomes
* How Smart Matching Works
  * Matching Criteria
  * Printer Assignment Strategy
* Managing Your Queue
  * Job Organization
  * Grouped Rows
  * Queue Priority
  * Archiving Finished Jobs
  * Troubleshooting Assignment Issues
* Production Slot Management
* Related Topics

### [materials](https://docs.printago.io/docs/printing/materials)

* Key Concepts
* How Materials Work
  * 1. Base Materials
  * 2. Material Variants (Colors)
    * Dual-Color Filaments
* Material Assignment
  * Adding Materials
  * Manual Material Creation
  * Built-in Material Database
  * Adding All Material Variants
* Slicing Profile Configuration
  * Configuring Material Profiles
  * Profile Resolution Priority
* Assigning Materials to Printers
* Material Override When Queuing Jobs
* Job Matching System
  * Material Matching Levels
  * Matching Examples
  * Multi-Color 3MF Matching
* Material Tips
* Common Issues

### [slicer-profiles](https://docs.printago.io/docs/printing/slicer-profiles)

* Key Concepts
* Getting Profiles into Printago
  * Option 1: Bambu Lab Cloud Sync
  * Option 2: Manual Import
* Managing Your Profiles
  * Searching Profiles
  * Deleting Profiles
* Editing Profiles
  * Profile Inheritance and Slicer Versions

### [cloud-slicer](https://docs.printago.io/docs/printing/cloud-slicer)

* Key Concepts
* How It Works
  * Slicing Workflow
* Profile Resolution
  * 1. Machine Profile
  * 2. Process Profile
  * 3. Filament Profile
* Intelligent Caching
* Slicer Selection
  * Available Slicers
  * Slicer Configuration
* GCODE Access
  * Download Method
  * File Format
  * Slicing Failures
    * Accessing Slicer Logs
  * Profile Issues

### [import-profiles](https://docs.printago.io/docs/printing/import-profiles)

* Supported File Formats
* Step 1: Export Profiles from Your Slicer
  * Exporting from Bambu Studio and OrcaSlicer
* Step 2: Upload to Printago
* Step 3: Select Profiles to Import
  * Profile Categories
  * Profile Status Badges
  * Selection Controls
  * New Materials Section
  * Import Options
* Step 4: Complete Import
* Tips

### [printer-management](https://docs.printago.io/docs/printing/printer-management/printer-management)

* Key Concepts
  * Required Configuration
  * Slicer Configuration Dialog
* Printers List
  * Display Information
  * Multi-Printer Actions
* Printer Page
  * Ready State Management
* Material Assignment
  * How Material Assignment Works
  * Bambu Lab RFID Enhancement
    * Automatic Material Detection
    * Missing Material Quick-Add
    * RFID Override
  * Material Slicer Configuration Warning
* AMS Configuration
* Related Documentation

### [printer-control-panel](https://docs.printago.io/docs/printing/printer-management/printer-control-panel)

* Individual Printer Control
  * Basic Controls
  * Calibration Tools
* Multi-Printer Control

### [printer-tags](https://docs.printago.io/docs/printing/printer-management/printer-tags)

* Understanding Printer Tags
* Managing Printer Tags
  * Single Printer Tag Management
  * Multi-Printer Tag Management
* Using Tags for Print Jobs
  * Printing to Tagged Printers
  * Dynamic Tag Updates
* Common Tag Use Cases
* Tips and Best Practices

### [fabmatic-continuous-printing](https://docs.printago.io/docs/printing/fabmatic-continuous-printing)

* Key Concepts
* How FabMatic Works
* Setup Overview
* Step 1: Create Clearing Profiles
  * Modify Your Slicer Profile
* Step 2: Sync Profiles to Printago
* Step 3: Enable FabMatic
* G-code Examples & Strategies
  * Basic End G-code Templates for Bambu
  * Time-Based Cooling
  * Semi-Automatic: PAUSE Command Method
* Material Considerations
  * PLA (Recommended for Auto-Ejection)
  * PETG (Challenging)
  * Part Geometry Impact
  * Humidity & Environmental Factors
* Managing FabMatic
  * Automatic Disable
  * Manual Control
  * Updating Clearing Scripts
* Troubleshooting
  * FabMatic Keeps Disabling
  * Profile Not Syncing
* Community Resources
  * 3D Printable Mods
  * Video Tutorials
  * Semi-Automatic "Person Ejection" Mode
  * When to Use What System
  * Getting Help

## Commerce

### [sku-management](https://docs.printago.io/docs/commerce/sku-management)

* Key Concepts
* Overview
* Creating SKUs
  * Basic SKU Setup
  * Material Overrides
  * Mixing Part Types in SKUs

### [sku-variants](https://docs.printago.io/docs/commerce/sku-variants)

* Overview
* Core Concepts
  * Variants
  * Variant Values
  * Properties
    * Material Properties
    * Text Properties
    * Plate Quantities Properties
  * Personalization Variants
* How It Works: The Complete Flow
  * Step 1: Create a Variant
  * Step 2: Add Properties
  * Step 3: Add Variant Values and Map Properties
  * Step 4: Assign Variants to SKUs
  * Step 5: Filter Variant Options for This SKU (Optional)
  * Step 6: Add SKU-Specific Properties (Optional)
  * Step 7: Create Compound Properties (Optional)
  * Step 8: Map Properties to Parts
    * Mapping Properties to Material Slots
    * Mapping Properties to OpenSCAD Parameters
    * Mapping Plate Quantities to Parts
* Printing SKUs with Variants
  * Options View (Default for SKUs with Variants)
  * Full View (Manual Control)
* Real-World Examples
  * Example 1: Simple Color Variation
  * Example 2: Multi-Material Support
  * Example 3: Complex Multi-Color Design
  * Example 4: E-Commerce Display Name Mapping
  * Example 5: Dynamic Sizing with OpenSCAD
  * Example 6: Personalized Text with Sizing
  * Example 7: Multi-Pack with Optimized Plate Quantities
  * Example 8: Variant Filtering for Product Line Subset
  * Example 9: SKU-Specific Dimensions Property
  * Example 10: Compound Material Properties
* E-Commerce Integration
  * Name Matching
  * Order Processing Flow
  * Handling New Options
* SKU Suffixes
  * When to Use
  * How It Works
    * Basic Concept
    * Parsing Rules
    * Example Configuration
  * Configuring SKU Suffixes
  * Testing Your Configuration
  * Validation
* ColorSCAD Integration
* Best Practices
  * Planning Your Variants
  * Naming Conventions
  * Testing Your Setup
  * Performance Tips
* Troubleshooting
  * Orders Stuck in Review
  * Wrong Materials Assigned
  * OpenSCAD Parameters Not Working
  * Missing Color Slots in 3MF
  * Variant Values Not Appearing When Printing
  * Compound Property Values Not Applying
  * SKU-Specific Property Not Visible
* Getting Help
  * Support Resources
  * 1:1 Setup Assistance
* Related Topics

### [printing-skus](https://docs.printago.io/docs/commerce/printing-skus)

* Starting a Print
  * Single SKU Printing
  * OpenSCAD Parameter Configuration
  * Bulk SKU Printing
* Printer Assignment
  * Assignment Methods
    * Next Available
    * Specific Printer
    * Tagged Printers
* Next Steps

### [orders](https://docs.printago.io/docs/commerce/orders)

* Key Concepts
* Overview
* Creating Manual Orders
  * Starting a New Order
  * Adding SKUs to Orders
  * Creating SKUs On-the-Fly
* Order to Print Queue Workflow
  * Understanding Print Job Creation
  * Queueing Print Jobs
* Order Management
  * Modifying Active Orders
  * Order Status and Job Tracking
  * Closing Completed Orders
* Order Tracking Features
  * Order Organization
  * Production Planning
* Integration with Print Queue
  * Smart Assignment
  * Order Tracking in Queue
* Common Use Cases
  * Custom Product Orders
  * Maker Space Projects
  * Prototype Batches
  * Event Production

## Integrations

### [shopify](https://docs.printago.io/docs/integrations/shopify)

* Key Concepts
* What You Get
* Before You Start
* Connect Shopify to Printago
  * 1. Install the Printago app in Shopify
  * 2. Connect from the Shopify app
  * 3. Verify connected status
* Synced Orders Dashboard
  * Dashboard Features
  * Order Status
  * Actions
  * Manual Sync
  * Real-time Sync
* Order Production Status
* Settings
  * Automatically Print Orders
  * Write Progress Tags
  * Auto-close Orders
  * Line Item Properties
  * Ignored Variant Names
  * Connection Info
  * Disconnect
* SKU Variant Support
  * Option-based matching
  * SKU suffix matching
  * Line item property matching
  * How resolution works
* Troubleshooting
  * Store shows as not connected
  * Orders are not syncing
  * Items show errors or "No jobs"
  * Print action fails
* Need Help?

### [etsy](https://docs.printago.io/docs/integrations/etsy)

* Key Concepts
* Overview
* Getting Started
  * 1. Activate the Addon
  * 2. Connect Your Etsy Shop
  * 3. Verify Connection
* Features
  * Automatic Order Sync
    * Manual Sync
    * Sync Behavior
  * Etsy → Printago: SKU Mapping
  * Printago → Etsy: Create Draft Listings
  * Etsy → Shopify CSV: Store Migration
* Order Management
  * Viewing Etsy Orders
  * Order Workflow
* Settings & Management
  * Ignored Variant Names
  * Subscription Management
  * Quick Actions
* Tips & Best Practices
  * SKU Management
  * Order Processing
  * Migration to Shopify
* Troubleshooting
  * Orders Not Syncing
  * SKU Mismatches
  * Connection Issues
* Support
* Technical Details
  * OAuth 2.0 Authentication
  * Sync Frequency
  * Data Privacy

### [shipstation](https://docs.printago.io/docs/integrations/shipstation)

* Features
* Status

### [shippo](https://docs.printago.io/docs/integrations/shippo)

* Features
* Status

### [ebay](https://docs.printago.io/docs/integrations/ebay)

* Features
* Status

## Tools & Workflows

### [hot-drop-file-upload](https://docs.printago.io/docs/tools/hot-drop-file-upload)

* Key Concepts
* How Hot Drop Works
  * Upload Options
* 3MF File Handling
* Organization
* Supported File Types
* Tips for Bulk Uploads

### [bulk-actions](https://docs.printago.io/docs/tools/bulk-actions)

* Understanding the Interface
  * Selection Patterns
* Bulk Actions by Context
  * Print Queue Management
  * Printer Management
  * Part & SKU Management
* Complete Bulk Actions Reference
  * Print Queue
  * Printers
  * Parts & SKUs
  * Materials & Slicer Profiles

### [folders](https://docs.printago.io/docs/tools/folders)

* Creating and Managing Folders
* Working with Folders
* Adding New Items

### [global-search](https://docs.printago.io/docs/tools/global-search)

* Opening Global Search
* Searching Your Workspace

### [keyboard-shortcuts](https://docs.printago.io/docs/tools/keyboard-shortcuts)

* Where to Find Keyboard Shortcuts
  * Global Navigation
  * Bulk Actions & Selection
  * Printer Management
* Quick Reference

### [notifications](https://docs.printago.io/docs/tools/notifications)

* Discord Notifications
* Setup Steps
  * 1. Create a Discord Webhook
  * 2. Configure Printago
* Webhook Notifications
  * Setup Steps
  * Webhook Payload Format
  * API Key Security

### [pwa-install](https://docs.printago.io/docs/tools/pwa-install)

* What is a PWA?
* Windows Installation
  * Using Chrome or Edge
    * OR
* macOS Installation
  * Using Chrome
  * Using Safari
* iPhone and iPad Installation
* Android Installation
  * Using Chrome
* Troubleshooting Installation
* Uninstalling Printago PWA
  * Windows
  * macOS
  * iOS/iPadOS
  * Android
* Getting Help

## Organization

### [user-management](https://docs.printago.io/docs/organization/user-management)

* Key Concepts
* Inviting Users
  * Sending an Invitation
  * What Happens Next
  * Re-sending & Revoking
* Managing Roles & Permissions
  * Viewing a User
  * Assigning Roles
  * Granting & Revoking Individual Permissions
  * Removing a User
* Browse As User
  * Who Can Use It
  * How It Works
* Related Topics

### [permissions](https://docs.printago.io/docs/organization/permissions)

* System Roles
  * Role Comparison
* All Permissions
  * Organization
  * Users & Permissions
  * Parts
  * SKUs
  * Materials
  * Printers
  * Slicer Profiles
  * Print Queue & Jobs
  * Builds
  * Orders
  * Settings & Integrations
  * Subscription & Billing
  * Analytics & Audit
  * API Keys
  * Files

### [audit-log](https://docs.printago.io/docs/organization/audit-log)

* Setup
* Availability
* What's Tracked
  * Action Types
  * Actor Types
  * Detailed Actions
* Navigating the Audit Log
  * Toolbar
  * Filtering
  * System Events
  * Correlation Grouping
  * Viewing Details
* Exporting Logs
* Related Topics

## API

### [keys](https://docs.printago.io/docs/api/keys)

* Key Concepts
* Managing API Keys
  * Viewing Your Keys
  * Creating a Key
  * Editing a Key
  * Deactivating vs. Deleting
  * IP Allowlists
* Related Topics

### [authentication-and-quotas](https://docs.printago.io/docs/api/authentication-and-quotas)

* Authentication
  * Required Headers
  * How Permissions Apply
* Rate Limits
* Real-time Data with MQTT
  * Connection Details
  * MQTT Client ID
  * Subscription Topics
* Swagger / OpenAPI Specification

### [examples](https://docs.printago.io/docs/api/examples)

* Code Examples
* Python — One-off Printing of an STL via API
  * Variables to Set
* What's Possible with the API

### [developers-site](https://docs.printago.io/docs/api/developers-site)

* Quick Links

### [ai-agents](https://docs.printago.io/docs/api/ai-agents)

* What's Available
* Recommended Workflow
* Pointing Claude Code at the Docs
* Pointing a Custom Agent at the Docs
* Freshness
* Feedback

## Settings

### [account-settings](https://docs.printago.io/docs/settings/account-settings)

* Account Security
  * Passkeys (Recommended)
    * Setting up a Passkey
    * Passkeys and MFA
  * Multi-factor Authentication (MFA)
    * Setting up MFA
    * Using MFA
* Notifications
* General Settings
  * Auto-match Materials for New Parts
  * Auto-match Materials on Re-upload
* Slicer Settings
  * Preferred Slicer Options
  * Available Slicers
* Affiliate Program
  * How it Works

### [subscription-management](https://docs.printago.io/docs/settings/subscription-management)

* Account Types
* Production Slots
* Managing Your Subscription
  * Accessing Subscription Settings
  * Managing Production Slots
* Account Type Changes

## Troubleshooting

### [common-issues](https://docs.printago.io/docs/troubleshooting/common-issues)

* Printer Connection Issues
  * Bambu Lab Authentication Expiry
  * Bambu Lab Connection Issues
  * Printago Fuse — Printers Not Discovered
* Printing & Slicing Issues
  * Cloud Slicer Failures
  * Profile Not Syncing
  * Print Queue Assignment Issues
* FabMatic Issues
  * FabMatic Keeps Disabling
* Material Issues
  * Materials Not Matching Printers
* Integration Issues
  * Shopify / Etsy Connection Problems
* Getting Help

## Support

### [support](https://docs.printago.io/docs/support)

* Discord Community 💬
* Email Support 📧