Troubleshooting

PDF Generation Issues

Fields show placeholder text instead of data

Your data-bound fields are appearing with their placeholder text instead of values from the API request.

• Check field keys match exactly — the field key in the editor (e.g., customer_name) must match the key in your API data object. Keys are case-sensitive.
• Make sure you're passing data — verify your API request includes a data object with the right keys.
• Check for typos — a field key of customerName won't match data with key customer_name.

Table appears empty

• Ensure the table's data key matches the array in your data object
• Verify the data is an array of objects, not a single object
• Check that column field keys match the object property names

// ✅ Correct — line_items is an array of objects
{
  "line_items": [
    { "description": "Item 1", "price": "$10" },
    { "description": "Item 2", "price": "$20" }
  ]
}

// ❌ Wrong — line_items is a single object
{
  "line_items": { "description": "Item 1", "price": "$10" }
}

PDF is blank or has wrong layout

• Make sure elements are positioned within the page bounds — elements outside the visible area won't appear
• Check element visibility in the Layers panel — elements might be hidden
• Verify the page orientation matches your design (Portrait vs Landscape)

API Errors

401 Unauthorized

• Double-check your API key is correct and hasn't been revoked
• Ensure the Authorization header format is Bearer YOUR_KEY (with a space after "Bearer")
• Verify the key belongs to the right project

404 Template Not Found

• Check the templateId is correct (find it in the dashboard URL or template settings)
• Ensure the API key has access to the project containing this template
• Verify the template has been saved (unsaved changes won't be available via API)

429 Rate Limited

• You're making too many requests. Add a delay between API calls.
• For bulk generation, add a short pause (100–500ms) between requests
• Contact support if you need higher rate limits

Editor Issues

Can't select an element on the canvas

• The element might be behind another element. Use the Layers panel to select it.
• The element might be locked. Unlock it from the Layers panel.
• Try zooming in — small elements can be difficult to click.

Changes not saving

• Check your internet connection
• Look for error messages in the editor toolbar
• Try saving manually with Ctrl+S (or ⌘+S on Mac)

Elements overlapping unexpectedly

• Use the Layers panel to reorder elements (drag to change z-order)
• Check element positions in the Inspector for exact pixel placement
• Use alignment tools to distribute elements evenly

SDK Issues

Request timeouts

• Complex templates with many elements or large images may take longer to generate
• Increase the SDK timeout setting (default is 30 seconds)
• Optimize images — use compressed formats and reasonable dimensions

SDK installation errors

• Node.js: Requires Node 18 or later. Check with node --version
• Python: Requires Python 3.8 or later. Check with python --version
• Go: Requires Go 1.21 or later. Check with go version