Frequently asked questions about Pogodoc - everything you need to know about document generation, templates, integrations, and more

Frequently Asked Questions

Welcome to the Pogodoc FAQ! This comprehensive resource answers common questions about using Pogodoc effectively. Whether you're new to the platform or looking to deepen your understanding, you'll find answers about getting started, document generation, templates, integrations, security, and more.

Can't find your question? Reach out to our support team or join our Discord community for help.

Getting Started

Do I need coding experience to use Pogodoc?

Yes, basic knowledge of HTML or a frontend framework is recommended to make the most of Pogodoc's capabilities. However:

Template Creation: You can use our AI-powered template builder to generate templates using natural language - no coding required! Just describe what you need, and our AI creates the template for you.
Visual Editor: Our dashboard includes a visual editor for non-technical users to customize templates without writing code.
Community Templates: Browse and use pre-built templates from our community library.
For Developers: If you're comfortable with HTML, React, Vue, or other web technologies, you'll have full control over template design.

Learn more in our Get Started guides and Templates documentation.

How do I get started with Pogodoc?

Getting started is simple:

Sign up at app.pogodoc.com
Choose a plan - We offer Free, Starter, Professional, and Enterprise tiers
Generate an API token at app.pogodoc.com/api-tokens
Install an SDK or use our REST API
Create your first template using our dashboard or AI builder
Generate your first document using our SDK

Check out our language-specific quickstart guides:

Which programming languages are supported?

Pogodoc provides official SDKs for:

TypeScript/JavaScript - Full-featured SDK for Node.js with TypeScript support (View SDK)
Python - Native Python SDK with async support (View SDK)
PHP - Composer-based SDK for PHP applications (View SDK)
Golang - Idiomatic Go SDK (View SDK)
.NET - C# SDK for .NET applications (View SDK)

Don't see your language? You can:

Use our REST API directly from any language
Build your own SDK using our comprehensive API documentation

Is there a free plan?

Yes! We offer a Free Plan that includes:

Limited document generation for testing and development
Access to basic templates
Community support
API token generation

For production use and higher limits, we recommend our paid plans.

Document Generation

What types of documents can I create with Pogodoc?

Pogodoc enables you to create virtually any document type, including:

Business Documents:

Invoices and receipts
Quotes and proposals
Purchase orders
Financial reports
Contracts and agreements

Marketing Materials:

Social media graphics
Email templates
Certificates and badges
Event tickets and passes
Promotional materials

Reports & Analytics:

PDF reports with charts and graphs
Data visualizations
Analytics dashboards
Performance summaries

Custom Documents:

Forms and applications
Labels and stickers
Product catalogs
Any custom document you can design!

By using templates and integrating real-time data, you can generate dynamic, professional documents on demand. See our Templates guide for examples.

How fast is document generation?

Document generation speed depends on several factors:

Typical Generation Times:

Immediate Render (synchronous): 1-5 seconds for most documents
Standard Render (asynchronous): Processing starts immediately, completion in 1-30 seconds depending on complexity

Factors affecting speed:

Template complexity (number of pages, images, charts)
Data size (thousands of rows vs. simple data)
Output format (PDFs take longer than PNGs)
Server load (Enterprise plans get priority processing)

Performance tips:

Use asynchronous rendering for complex documents
Cache generated documents when possible
Optimize images in templates
Consider batch processing for multiple documents

Can I generate multiple documents at once?

Yes! There are several approaches:

1. Batch Processing (Recommended):

const documents = await Promise.all(
  orders.map((order) =>
    client.generateDocument({
      template: "invoice",
      data: order,
      target: "pdf",
    })
  )
);

2. Asynchronous Generation: Start multiple jobs and poll for completion:

const jobs = await Promise.all(
  orders.map(order => client.startGenerateDocument({...}))
);
// Poll each job separately

3. Enterprise Bulk API: Contact [email protected] for dedicated bulk generation endpoints with higher throughput.

See our SDK documentation for batch processing examples.

Can I generate documents without templates?

Yes! You can generate documents using inline templates - pass the template code directly in your API request:

const document = await client.generateDocumentImmediate({
  template: "<h1>Hello <%= name %></h1><p><%= message %></p>",
  data: { name: "World", message: "This is an inline template!" },
  type: "ejs",
  target: "pdf",
});

This is great for:

Quick prototypes and testing
Simple, dynamic documents
One-off document generation
When you don't want to manage templates in the dashboard

For production use, we recommend saving templates in the dashboard for:

Reusability
Team collaboration
Visual editing

Templates

Is there a library of templates available?

Yes! Pogodoc provides multiple ways to access templates:

1. Community Templates Library Browse professionally designed templates in our community library:

Invoices, receipts, and financial documents
Social media graphics and marketing materials
Reports, certificates, and badges
Clone and customize any template

2. AI Template Generation Use our AI chatbot to create custom templates:

Describe your needs in plain English
AI generates a complete template with sample data
Edit and refine using our visual editor
Save for future use

3. Upload Your Own Create templates using any web technology:

HTML/CSS with EJS templating
React, Vue, Svelte, or any framework
Upload as a ZIP file
Full control over design and styling

Learn more in our Templates documentation.

What template formats are supported?

Pogodoc supports multiple template formats:

HTML-Based Templates:

EJS (Embedded JavaScript) - Simple, powerful templating with placeholders
HTML - Pure HTML with static data

JavaScript Frameworks:

React - Build templates with React components
Vue - Use Vue components and composition API
Svelte - Compile-time templates with Svelte
any other framework

Framework-Agnostic: Any web technology that compiles to HTML/CSS/JS works! Build with your preferred tools and upload the bundle.

See our Templates guide for detailed information and examples.

Can I use custom fonts in my templates?

Yes! You can use custom fonts in several ways:

1. Web Fonts (Google Fonts, etc.):

<link
  href="https://fonts.googleapis.com/css2?family=Roboto:wght@400;700&display=swap"
  rel="stylesheet"
/>
<style>
  body {
    font-family: "Roboto", sans-serif;
  }
</style>

2. Self-Hosted Fonts: Include font files in your template ZIP:

@font-face {
  font-family: "CustomFont";
  src: url("./fonts/custom.woff2") format("woff2");
}
body {
  font-family: "CustomFont", sans-serif;
}

3. Base64 Embedded Fonts: Embed font data directly in CSS (increases template size).

Best practices:

Use common web fonts for faster rendering
Include fallback fonts: font-family: 'CustomFont', Arial, sans-serif
Optimize font files (use WOFF2 format)
Only include weights you actually use

Can I use images in my templates?

Absolutely! You can include images in multiple ways:

1. External URLs:

<img src="https://example.com/logo.png" alt="Company Logo" />

2. Base64 Encoded:

<img src="data:image/png;base64,iVBORw0KG..." alt="Logo" />

3. Bundled in Template: Include images in your template ZIP file:

<img src="./assets/logo.png" alt="Logo" />

4. Dynamic from Data:

<img src="<%= product.imageUrl %>" alt="<%= product.name %>" />

Performance tips:

Optimize image sizes before including
Use appropriate formats (PNG for logos, JPEG for photos)
Consider lazy loading for multi-page documents
For frequently used logos, use external URLs (cached by CDN)

How do I update an existing template?

You can update templates in several ways:

Via Dashboard:

Go to My Templates
Click on the template options button on the template you want to edit
Make changes in the visual editor or code editor
Click "Save" - your changes are live immediately

Or do it via our SDKs or API.

Yes! Reusability is one of the key advantages of templates.

Integration & Development

Does Pogodoc integrate with other tools and platforms?

Yes! Pogodoc is framework-agnostic and integrates seamlessly with:

Backend Frameworks:

Node.js (Express, Fastify, NestJS)
Django, Flask, FastAPI (Python)
Laravel, Symfony (PHP)
ASP.NET Core (.NET)
Go (Gin, Echo, Chi)

Cloud Platforms:

AWS Lambda, EC2, ECS
Google Cloud Functions, Cloud Run
Azure Functions, App Service
Heroku, Vercel, Netlify

CMS & Tools:

WordPress, Drupal, Joomla
Strapi, Contentful, Sanity
Zapier, Make, n8n (automation)

Databases:

PostgreSQL, MySQL, MongoDB
Any database you can query from your backend

APIs:

REST APIs
GraphQL APIs
Webhooks

Pogodoc provides a RESTful API, so it works with any platform that can make HTTP requests. See our SDK documentation for integration examples.

Can I use Pogodoc with serverless functions?

Absolutely! Pogodoc works great with serverless architectures:

Supported Platforms:

AWS Lambda
Google Cloud Functions
Azure Functions
Vercel Serverless Functions
Netlify Functions
Cloudflare Workers

Example (AWS Lambda):

import { PogodocClient } from "@pogodoc/sdk";

// Initialize outside handler for connection reuse
const client = new PogodocClient({
  token: process.env.POGODOC_API_TOKEN,
});

export const handler = async (event) => {
  const document = await client.generateDocumentImmediate({
    template: event.template,
    data: event.data,
    type: "ejs",
    target: "pdf",
  });

  return {
    statusCode: 200,
    body: JSON.stringify({ documentUrl: document.url }),
  };
};

Best practices:

Initialize SDK client outside handler (reuse connections)
Use environment variables for API tokens
Consider async generation for complex documents
Set appropriate timeout limits (30+ seconds for complex docs)

See our SDK guide for more examples.

Can I self-host Pogodoc?

Yes! We offer on-premise deployment for Enterprise customers:

Enterprise On-Premise Features:

Complete control over your infrastructure
Full data ownership and privacy
No external API calls
Custom security configurations
Air-gapped environments supported
Dedicated onboarding and support

Deployment Options:

Docker containers
Kubernetes clusters
Traditional VM deployments
Cloud VPC deployments

Contact our sales team: Email [email protected] to discuss on-premise deployment options, pricing, and support.

Security & Privacy

Is my data secure with Pogodoc?

Yes! We take security seriously:

Cloud Security (Standard Plans):

Hosted on AWS with enterprise-grade security
Data encrypted in transit (TLS 1.3)
Data encrypted at rest (AES-256)
Regular security audits and penetration testing
SOC 2 Type II compliance (in progress)
GDPR and CCPA compliant

Enterprise Security:

On-premise deployment for complete control
Air-gapped environments supported
Custom security configurations
Dedicated security reviews
SSO/SAML integration
Audit logging

Data Handling:

We don't store your document data longer than necessary
Generated documents are stored temporarily
You can delete documents immediately after generation
Templates are stored securely with access controls

Best practices:

Use environment variables for API tokens
Rotate tokens regularly (quarterly recommended)
Implement least-privilege access controls
Monitor API usage for anomalies

Where is my data stored?

Cloud Deployments (Standard Plans):

Primary hosting: AWS

Data Storage:

Templates: Stored securely in S3 and our databases
Generated Documents: S3-compatible storage with signed URLs
Temporary Data: Processing data is deleted after generation

Enterprise On-Premise:

You control all data storage locations
No data leaves your infrastructure
Full data sovereignty
Works offline

Data Retention:

Generated documents: 24 hours
Templates: Stored indefinitely until you delete them

Contact [email protected] for custom data residency requirements.

Are API tokens secure?

Yes, when used properly. Follow these best practices:

✅ DO:

Store tokens in environment variables
Use secret management systems (AWS Secrets Manager, Azure Key Vault)
Rotate tokens quarterly
Use separate tokens per environment (dev, staging, prod)
Delete unused tokens immediately
Monitor token usage in the dashboard

❌ DON'T:

Commit tokens to Git/version control
Share tokens publicly or in chat/email
Hardcode tokens in source code
Use the same token across all environments
Expose tokens in frontend code

If a token is compromised:

Delete it immediately from the dashboard
Generate a new token
Update all applications with the new token
Review usage logs for suspicious activity
Contact support if needed

Learn more in our API Tokens documentation.

Features & Capabilities

Does Pogodoc support responsive design?

Yes! Pogodoc supports responsive templates:

Dynamic Templates:

Use CSS media queries for different screen sizes
Responsive layouts that adapt to content
Mobile-friendly designs

No-Code Editor:

Our visual editor allows non-developers to create responsive templates
Drag-and-drop interface
Live preview for different sizes

Example Responsive Template:

/* Desktop */
.container {
  width: 800px;
}

/* Tablet */
@media (max-width: 768px) {
  .container {
    width: 100%;
  }
}

/* Mobile */
@media (max-width: 480px) {
  .container {
    padding: 10px;
  }
}

Page Size Control:

Set specific page sizes (A4, Letter, etc.)
Custom dimensions for any output format
Portrait or landscape orientation

See our Templates documentation for responsive design examples.

Can I generate documents with charts and graphs?

Yes! You can include dynamic charts and visualizations:

Chart Libraries:

Chart.js - Popular canvas-based charts
D3.js - Powerful, flexible visualizations
Recharts - React charting library
ApexCharts - Modern, interactive charts

Example with Chart.js:

<canvas id="myChart"></canvas>
<script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
<script>
  new Chart('myChart', {
    type: 'bar',
    data: {
      labels: <%= JSON.stringify(labels) %>,
      datasets: [{
        label: 'Sales',
        data: <%= JSON.stringify(values) %>
      }]
    }
  });
</script>

Can I add QR codes or barcodes to documents?

Absolutely! You can generate QR codes and barcodes dynamically:

QR Codes:

<img
  src="https://api.qrserver.com/v1/create-qr-code/?data=<%= orderUrl %>&size=200x200"
  alt="Order QR"
/>

Using QR Code Libraries:

// In your template
const QRCode = require("qrcode");
const qrCodeUrl = await QRCode.toDataURL(orderData.url);

<img src="<%= qrCodeUrl %>" alt="QR Code" />

Barcodes:

<!-- Using JsBarcode -->
<svg id="barcode"></svg>
<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/JsBarcode.all.min.js"></script>
<script>
  JsBarcode("#barcode", "<%= orderNumber %>");
</script>

Use cases:

Order tracking codes
Product barcodes
Event tickets with QR codes
Payment links
Shipping labels

Can I use AI to generate templates?

Yes! Pogodoc includes AI-powered template generation:

AI Doc:

Follow the detailed explanation here.

AI Features:

Natural language template generation
Automatic sample data creation
Smart layout suggestions
Style recommendations

Advanced AI Features:

Document-to-Template Conversion: Upload an existing document (PDF, image) and AI extracts the template
Mobile Scanning: Use your phone to scan physical documents and convert to templates
Version History: AI tracks changes and allows reverting to previous versions
AI Model Selection: Choose between multiple models for different use cases

Learn more in our Managing Templates guide.

Can I schedule document generation?

While Pogodoc doesn't have built-in scheduling, you can easily implement it:

Using Cron Jobs:

# Generate daily report at 8 AM
0 8 * * * /usr/bin/node /path/to/generate-report.js

Using Task Schedulers:

Node.js: node-cron, Agenda, Bull
Python: APScheduler, Celery
Cloud: AWS EventBridge, Google Cloud Scheduler, Azure Functions Timer

Example with node-cron:

import cron from "node-cron";
import { PogodocClient } from "@pogodoc/sdk";

const client = new PogodocClient({ token: process.env.POGODOC_API_TOKEN });

// Run every day at 9 AM
cron.schedule("0 9 * * *", async () => {
  const report = await client.generateDocument({
    template: "daily-report",
    data: await fetchDailyData(),
    target: "pdf",
  });
  await sendReportEmail(report.url);
});

Webhook-Based Scheduling:

Use services like Zapier or Make to trigger document generation
Set up scheduled workflows
Integrate with calendar events or other triggers

Billing & Pricing

Can I change plans at any time?

Yes! You can upgrade or downgrade your plan anytime. Both upgrading or downgrading take effect at the end of your current billing cycle. If you cancel your subscription you can still enjoy your plan until the end of the billing cycle.

Manage your plan:

Go to app.pogodoc.com/profile
Click "Manage Subscription" or select a specific plan
Select your new plan
Confirm changes

Billing Cycles:

Monthly billing
Annual billing (up to 50% discount)

How does pay-as-you-go work?

Pay-as-you-go starts once you have reached your plan limit for generated documents.

Each document generation costs $0.031415.

You can generate unlimited documents.

You will be charged every time your pay-as-you-go generated documents accumulate to $10. If they don't you will be charged at the end of the billing cycle.

You can use enjoy pay-as-you-go, while being on the Free Plan as well.

Support & Community

How do I get help if I'm stuck?

We offer multiple support channels:

Documentation:

Start with our comprehensive docs
Check this FAQ

Community Support:

Join our Discord server
Ask questions and share solutions
Connect with other Pogodoc users

Email Support:

Free/Starter: [email protected] (48-hour response)
Professional: Priority email support (24-hour response)
Enterprise: Dedicated support team (4-hour response)

Premium Support (Enterprise):

Dedicated Slack channel
Direct access to engineering team
Phone support available
Custom SLAs

Emergency Support: For production outages (Professional/Enterprise plans):

Email: [email protected]
Include: Account ID, error details, impact assessment

Can I request new features?

Absolutely! We love user feedback:

Feature Requests:

Join our Discord community
Post in the #feature-requests channel
Vote on existing requests
Discuss with other users and our team

Direct Requests: Email [email protected] with:

Detailed description of the feature
Your use case and why it's important
Expected behavior or examples
Willingness to beta test

Enterprise Customers:

Direct input on our roadmap
Custom feature development available
Priority implementation for critical needs

Are there any video tutorials or courses?

Yes! We offer various learning resources:

Video Tutorials:

YouTube Channel - Getting started guides, feature demos
Quick start videos
Template design tutorials
Advanced techniques and best practices

Written Guides:

Blog - Tutorials, use cases, tips & tricks
Case studies from real users
Industry-specific guides (e.g., invoicing, reports)

Interactive Learning:

Sample projects in our GitHub organization
Code snippets in the dashboard

FAQs

Get Started

SDK Documentation

Templates Guide

API Tokens

API Reference

Community Discord

On this page