# PDF Generation Issues Troubleshoot common issues with PDF generation in Draft Order Magic. ### Common PDF problems #### PDF won't generate or download **Symptoms:** * Click "Generate PDF" but nothing happens * Button doesn't respond * No download starts * Spinner keeps spinning **Solutions:** 1. **Check browser download settings** * Ensure downloads are allowed * Check if popup blocker is active * Look in browser's downloads folder * Try clicking "Generate PDF" again 2. **Check popup blocker** * Disable popup blocker for Shopify admin * Add Shopify to popup exceptions * Try again after disabling 3. **Verify PDF feature is enabled** * Go to **Print Settings** * Check "Enable PDF generation" is ON * Save if you made changes * Try generating PDF again 4. **Check draft order requirements** * Draft must have at least one line item * Customer should be assigned * Save draft order first, then generate PDF * All required fields should be filled 5. **Try different method** * If generating from editor fails, try from Shopify admin * Go to draft order in Shopify → **More actions** → **Print PDF** * Or try from Draft Order Magic homepage #### PDF is blank or missing content **Symptoms:** * PDF downloads but shows blank pages * Missing logo, business info, or line items * Incomplete information **Solutions:** 1. **Check Print Settings configuration** * Go to **Print Settings** * Verify business information is filled in * Check logo is uploaded * Ensure custom notes are entered (if desired) * Save settings 2. **Re-upload logo** * Delete current logo * Upload logo again * Verify logo preview shows correctly * Generate new PDF 3. **Verify draft order data** * Check draft has line items * Ensure customer is assigned * Verify products have prices * Check all required fields are complete 4. **Generate fresh PDF** * Old PDFs don't update automatically * Always generate new PDF after changes * Don't reuse old PDF files #### Logo not appearing in PDF **Symptoms:** * PDF generates but logo is missing * Logo placeholder shows * Logo was uploaded but doesn't display **Solutions:** 1. **Check logo file** * Use PNG format (recommended) * File size should be under 2MB * Dimensions: 300-600px wide recommended * Try re-uploading at smaller size 2. **Verify logo uploaded successfully** * Go to **Print Settings** * Check logo preview appears * If no preview, upload again * Click Save after uploading 3. **Try different image format** * Convert logo to PNG if using JPG * Ensure no transparency issues * Try simpler logo file * Reduce file size if very large 4. **Clear and re-upload** * Remove current logo * Save settings * Upload logo again * Generate new PDF #### PDF formatting looks wrong **Symptoms:** * Text overlaps or is cut off * Items don't align properly * Page breaks in wrong places * Layout appears broken **Solutions:** 1. **Check in different PDF viewer** * Browser PDF viewer may render differently * Download and open in Adobe Acrobat Reader * Try opening in Mac Preview or Windows PDF viewer * If looks good in one viewer, it's a rendering issue 2. **Check for very long product names** * Extremely long product names can break layout * Consider shortening product names in Shopify * Or accept layout with long names 3. **Check for many line item properties** * Too many properties can affect layout * Consider consolidating properties * Or split into multiple draft orders 4. **Generate fresh PDF** * Delete old PDF * Generate new one * Check if issue persists #### PDF won't open or is corrupted **Symptoms:** * "File is damaged" error * PDF won't open in any viewer * Partial download **Solutions:** 1. **Download PDF again** * Previous download may have been interrupted * Generate and download fresh copy * Ensure download completes fully 2. **Check file size** * Corrupted PDFs are often 0 KB or very small * Compare to expected size (should be 100KB+) * If too small, regenerate 3. **Try different browser** * Generate PDF in Chrome * Try Firefox as alternative * Some browsers handle PDF generation better 4. **Check disk space** * Ensure you have adequate disk space * Clear downloads folder * Try downloading again #### "Print PDF" button missing in Shopify admin **Symptoms:** * Can't find Print PDF option in More actions menu * Button doesn't appear on draft order page **Solutions:** 1. **Verify PDF feature is enabled** * Go to Draft Order Magic **Print Settings** * Check "Enable PDF generation" is ON * Save settings * Refresh Shopify admin 2. **Check draft order status** * Button only appears on open draft orders * Completed orders don't show the button * Create or open a draft order 3. **Verify app is installed** * Ensure Draft Order Magic is still installed * Check in **Settings → Apps and sales channels** * Reinstall if necessary 4. **Refresh the page** * Hard refresh Shopify admin (Cmd/Ctrl + Shift + R) * Log out and back in * Try again #### PDF shows old information **Symptoms:** * Updated prices don't appear in PDF * Old business information shows * Changed logo doesn't appear **Solutions:** 1. **Generate NEW PDF** * Old PDFs never update automatically * Must generate fresh PDF to see changes * Delete old PDF to avoid confusion 2. **Verify changes were saved** * Check draft order shows updated info in editor * Verify Print Settings changes were saved * Confirm logo upload completed 3. **Clear browser cache** * Old cached version may be showing * Clear cache and hard refresh * Generate PDF again ### Prevention tips * Configure Print Settings before first PDF * Test PDF generation with sample draft order * Save draft orders before generating PDFs * Use PNG format for logos * Keep product names reasonable length * Generate new PDF after any changes ### Need more help? If PDFs still aren't working: 1. **Gather information:** * Screenshot of the issue * Browser and version * What happens when you click Generate PDF * Any error messages * Draft order number 2. **Contact support:** * Email: * Include screenshots and details * Provide store URL * Describe steps you've tried ### Related articles * [Print settings configuration](https://github.com/horselditty/draft-order-docs/blob/main/product/print/settings/README.md) * [Generating PDFs guide](https://github.com/horselditty/draft-order-docs/blob/main/product/print/generating-pdfs/README.md) * [Editor not loading](https://github.com/horselditty/draft-order-docs/blob/main/support/troubleshooting/editor-not-loading/README.md) * [Contact support](https://github.com/horselditty/draft-order-docs/blob/main/support/contact-support/README.md) --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://responsive-media.gitbook.io/draft-order-magic/support-and-help/index-1/pdf-generation-issues.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.