> ## Documentation Index
> Fetch the complete documentation index at: https://docs.peedief.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Frequently Asked Questions

> Common questions about Peedief Template to PDF platform

# Frequently Asked Questions

## Template Questions

<Accordion title="How do I find the right template for my needs?">
  Use the template discovery API to explore available templates:

  1. **List by category**: Filter templates by type (certificates, invoices, reports, letters)
  2. **Search by tags**: Find templates with specific features or industries
  3. **Review metadata**: Check each template's data requirements and sample output
  4. **Try samples**: Use the sample data provided to test template output

  **Example:**

  ```bash theme={null}
  curl "https://peedief.com/api/templates?category=certificates" \
    -H "x-api-key: YOUR_API_KEY"
  ```
</Accordion>

<Accordion title="How long does it take to generate a PDF from a template?">
  Template-based PDF generation is typically **1-3 seconds** for most documents. This is faster than HTML-to-PDF because:

  * Templates are pre-optimized and cached
  * No HTML parsing or CSS processing required
  * Data validation happens before generation
  * Professional layouts are already optimized

  **Factors affecting speed:**

  * Template complexity
  * Amount of data (number of items in arrays)
  * Image processing requirements
  * Your plan type (Premium gets priority)
</Accordion>

<Accordion title="Can I customize existing templates?">
  Templates can be customized in several ways:

  **Data-driven customization:**

  * All templates support branding (logos, colors, company info)
  * Conditional content based on your data
  * Dynamic sections that show/hide based on data presence

  **Template modifications:**

  * Contact support for custom template modifications
  * Enterprise plans include custom template creation
  * Templates can be updated and modified as needed

  **Styling options:**

  * Custom CSS can be added to existing templates
  * Brand colors and fonts can be configured
  * Layout adjustments for specific use cases
</Accordion>

## General Questions

<Accordion title="Do you support non-English content?">
  **Yes!** We fully support UTF-8 encoding for:

  * International characters and symbols
  * Right-to-left languages (Arabic, Hebrew)
  * Asian languages (Chinese, Japanese, Korean)
  * Accented characters (French, Spanish, German, etc.)
  * Mathematical symbols and special characters

  Just ensure your HTML includes proper charset declaration:

  ```html theme={null}
  <meta charset="utf-8">
  ```
</Accordion>

## Technical Questions

<Accordion title="Can I use JavaScript in my HTML?">
  **Limited support.** JavaScript runs during rendering, but there are restrictions:

  **✅ What works:**

  * Simple DOM manipulation
  * Basic calculations and formatting
  * Library initialization (Chart.js, etc.)

  **❌ What to avoid:**

  * External API calls (may timeout)
  * Complex async operations
  * Long-running scripts
  * WebSocket connections

  **Best practice:** Pre-render dynamic content on your server before sending HTML to Peedief.
</Accordion>

<Accordion title="How do I add headers and footers?">
  Use CSS `@page` rules for professional headers and footers:

  ```css theme={null}
  @page {
    margin-top: 2in;
    margin-bottom: 2in;
    
    @top-center {
      content: "Document Title";
      font-family: Arial;
      font-size: 10pt;
      color: #666;
    }
    
    @bottom-center {
      content: "Page " counter(page) " of " counter(pages);
      font-family: Arial;
      font-size: 10pt;
    }
    
    @bottom-right {
      content: "Generated on " date();
      font-size: 9pt;
      color: #999;
    }
  }
  ```

  **Advanced options:**

  * `counter(page)` - Current page number
  * `counter(pages)` - Total pages
  * `date()` - Generation date
  * Different headers/footers for first page
</Accordion>

<Accordion title="Can I embed fonts?">
  **Yes!** You can embed custom fonts using base64 encoding:

  ```css theme={null}
  @font-face {
    font-family: 'CustomFont';
    src: url('data:font/woff2;base64,d09G...');
    font-weight: normal;
    font-style: normal;
  }

  body {
    font-family: 'CustomFont', Arial, sans-serif;
  }
  ```

  **Font guidelines:**

  * Use WOFF2 format for smaller file sizes
  * Always provide fallback fonts
  * Keep font files under 500KB each
  * Test fonts in different browsers first
</Accordion>

<Accordion title="How do I handle large tables?">
  Large tables require special CSS handling for page breaks:

  ```css theme={null}
  table { 
    page-break-inside: auto;
    border-collapse: collapse;
    width: 100%;
  }

  tr { 
    page-break-inside: avoid;
    page-break-after: auto;
  }

  thead {
    display: table-header-group;
    page-break-after: avoid;
  }

  tbody {
    display: table-row-group;
  }

  /* Repeat header on each page */
  @media print {
    thead {
      display: table-header-group;
    }
  }
  ```

  **For very wide tables:** Consider rotating to landscape mode or splitting into multiple tables.
</Accordion>

## Billing Questions

<Accordion title="What happens if I exceed my plan limits?">
  PDF generation will be **blocked** until you upgrade or your plan renews. We **never charge overage fees**.

  **When you hit limits:**

  1. API returns "Insufficient Balance" error
  2. Dashboard shows 100% usage
  3. Generation blocked until:
     * Plan upgrade (immediate)
     * Next billing cycle (automatic reset)
</Accordion>

<Accordion title="Can I change plans anytime?">
  **Yes!** Plan changes are flexible:

  **Upgrades:**

  * Take effect immediately
  * Prorated billing for remainder of cycle
  * New limits apply instantly
  * No downtime or service interruption

  **Downgrades:**

  * Take effect at next billing cycle
  * Current features remain until renewal
  * File storage adjusted to new plan limits

  **Example:** Upgrade from Starter to Basic on Jan 15th:

  * Pay prorated amount for 16 days of Basic plan
  * Immediately get 1,500 PDF limit
  * Next full billing on Feb 1st
</Accordion>

<Accordion title="Do unused PDFs roll over?">
  **No,** limits reset each billing cycle. However:

  * **Generated files remain accessible** according to storage retention
  * **Usage resets to 0** on your renewal date
  * **Plan benefits continue** throughout the billing period
</Accordion>

<Accordion title="Is there a bulk discount?">
  **Yes!** Enterprise plans with custom pricing are available:

  **Enterprise features:**

  * Custom PDF limits (10,000+/month)
  * Dedicated infrastructure
  * SLA guarantees
  * Priority support with account manager
  * Custom integrations and webhooks
  * Bulk pricing discounts

  **Contact:** [enterprise@peedief.com](mailto:enterprise@peedief.com) for custom pricing.
</Accordion>

## MCP Questions

<Accordion title="Which AI assistants support MCP tools?">
  **Primary Support:**

  * **Claude Desktop**
  * **Claude Web**
  * **n8n Workflow**

  **MCP-Compatible Clients:**

  * Any client implementing MCP protocol
  * Custom AI applications
  * Third-party MCP integrations

  **Setup Requirements:**

  * MCP-compatible client
  * Peedief API key
  * Proper authentication configuration
</Accordion>

<Accordion title="Can I use MCP tools without Claude Desktop?">
  **Yes!** Any MCP-compatible client can use Peedief tools:

  **Options:**

  * Custom MCP client implementations
  * Third-party MCP tools
  * Developer-built integrations
  * Future MCP-enabled applications

  **Requirements:**

  * MCP protocol support
  * API key authentication
  * Network access to Peedief servers
</Accordion>

<Accordion title="Are there usage limits for MCP tools?">
  **MCP tools count toward your regular plan limits:**

  * Same PDF generation limits apply
  * No separate MCP-specific restrictions
  * Standard rate limits enforced
  * All features available through MCP

  **Benefits:**

  * Unified usage tracking
  * Consistent billing across API and MCP
  * No additional setup or fees
  * Same support channels
</Accordion>

<Accordion title="Can I customize MCP tool behavior?">
  **Limited customization available:**

  **What you can configure:**

  * Authentication method (API key or OAuth)
  * Default PDF options (format, margins, etc.)
  * Error handling preferences
  * Timeout settings

  **What's standardized:**

  * Tool interface and commands
  * Response formats
  * Core functionality
  * Feature set

  **Advanced customization:** Enterprise plans can discuss custom MCP implementations.
</Accordion>

## Common Issues

<Accordion title="Why is my PDF blurry or low quality?">
  **Common causes and solutions:**

  **Images:**

  * Use high-resolution images (300+ DPI)
  * Optimize image formats (PNG for graphics, JPEG for photos)
  * Avoid scaling images with CSS

  **Fonts:**

  * Use web-safe fonts or properly embed custom fonts
  * Avoid very small font sizes (\<10pt)
  * Ensure proper font licensing

  **CSS:**

  ```css theme={null}
  /* High-quality rendering */
  img {
    image-rendering: optimizeQuality;
    max-width: 100%;
  }

  body {
    font-family: Arial, sans-serif;
    font-size: 12pt;
    line-height: 1.4;
  }
  ```
</Accordion>

<Accordion title="My table breaks awkwardly across pages">
  **Table pagination solutions:**

  ```css theme={null}
  /* Prevent breaking inside table rows */
  table {
    page-break-inside: auto;
  }

  tr {
    page-break-inside: avoid;
    page-break-after: auto;
  }

  /* Keep table headers visible */
  thead {
    display: table-header-group;
  }

  /* For very long tables */
  .long-table {
    page-break-before: always;
  }
  ```

  **Alternative approaches:**

  * Split large tables into sections
  * Use landscape orientation for wide tables
  * Consider alternative layouts (lists, cards)
</Accordion>

<Accordion title="External resources aren't loading">
  **Resource loading issues:**

  **Problem:** External images, fonts, or CSS files don't appear in PDF.

  **Solutions:**

  1. **Embed resources as data URLs:**

  ```html theme={null}
  <img src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUg..." />
  ```

  2. **Use absolute URLs:**

  ```html theme={null}
  <img src="https://example.com/image.png" alt="Description" />
  ```

  3. **Inline critical CSS:**

  ```html theme={null}
  <style>
  /* Critical styles here */
  </style>
  ```

  **Best practice:** Embed all critical resources to ensure reliability.
</Accordion>

## Getting More Help

<Card title="Still need help?">
  **Free Plan:** Visit our community forum for user support

  **Paid Plans:** Contact [support@peedief.com](mailto:support@peedief.com) with:

  * Your account email
  * Detailed issue description
  * Sample code or HTML (if applicable)
  * Error messages
  * Steps you've already tried

  **Premium Plans:** Phone support available during business hours
</Card>

## Useful Resources

<CardGroup cols={2}>
  <Card title="Status Page" icon="heart-pulse" href="https://status.peedief.com">
    Real-time service status and maintenance updates
  </Card>

  <Card title="API Documentation" icon="code" href="/api-integration">
    Complete API reference and integration examples
  </Card>

  <Card title="Community Forum" icon="users" href="https://community.peedief.com">
    User discussions, tips, and community support
  </Card>

  <Card title="Video Tutorials" icon="play" href="https://tutorials.peedief.com">
    Step-by-step video guides for common tasks
  </Card>
</CardGroup>