Frequently Asked Questions

Getting Started

What is FUNBREW PDF?

FUNBREW PDF is a REST API that generates PDFs from HTML and URLs. It's designed to automate document generation for invoices, certificates, reports, and more. It features two engines: Chromium (quality) and wkhtmltopdf (fast).

Is there a free plan?

Yes. The Free plan includes 30 PDFs/month with no credit card required. You can upgrade anytime from the dashboard.

Does it support Japanese?

Yes. Full support for Japanese, Chinese, Korean and other CJK characters. Fonts are pre-installed on the server.

Can I use custom fonts?

Yes. You can embed fonts using CSS @font-face in your HTML. Web fonts like Google Fonts work out of the box.

PDF Engine

What's the difference between 'quality' and 'fast' engines?

Quality uses Chromium with full CSS3/Flexbox/Grid support. Fast uses wkhtmltopdf for faster processing but limited CSS support. Quality is the default engine.

Can I use the quality engine on the Free plan?

The Free plan only supports the fast engine (wkhtmltopdf). The quality engine (Chromium) is available on Basic plans and above. You can try it for free in the Playground.

Can I change the default engine?

Yes. Set your company-wide default engine in Dashboard > Account Settings. You can also override per-request using options.engine in the API.

Expiration & Downloads

How does PDF expiration work?

By default, PDFs expire 24 hours after generation. Set expiration_hours (1-168) to customize. Set it to 0 for no expiration.

Can I change the default expiration?

Yes. Go to Dashboard > Download Page settings to change your company-wide default expiration. You can also set it to 'no expiry'.

How do I make a file permanent?

Set expiration_hours=0 in the API request, or set the default expiration to 'no expiry' in Download Page settings. Permanent files are never auto-deleted.

Is there a download limit?

The default is unlimited (0). Set max_downloads to add a limit. You can change the default in Dashboard > Download Page settings.

When are expired files deleted?

Expired files are auto-deleted 7 days after expiration (grace period). Files with no expiration (expiration_hours=0) are never auto-deleted.

Templates

What are templates?

Templates are HTML layouts with {{variable}} placeholders. Create and edit them in the template editor, then pass variables via API to generate PDFs.

How do I use the template editor?

Go to Dashboard > Templates > Create New. The code editor has syntax highlighting with real-time preview. Insert snippets (tables, headers, etc.) with one click.

Can I set default values for template variables?

Yes. In the template editor's variable definition panel, you can set default values and descriptions for each variable. If a variable is not provided in the API call, the default value is used.

Security

How is data secured?

All API traffic uses HTTPS. API keys are SHA-256 hashed. S3 credentials are encrypted. Per-company IP restrictions are available. Two-factor authentication (TOTP) is supported.

Is two-factor authentication available?

Yes. Enable TOTP-based 2FA in Dashboard > Account Settings. Works with Google Authenticator, Authy, and other authenticator apps. Recovery codes are provided.

Can I restrict API key permissions?

Yes. Set scopes (generate, download, manage, template, merge) per API key. For example, create a 'generate-only' key that cannot download or delete files.

Notifications

Can I send PDFs via email?

Yes. Add the email parameter to your API call to send the generated PDF as an email attachment. You can also set up automatic email delivery from the dashboard.

Which events do webhooks support?

Three events: pdf.generated, pdf.downloaded, and pdf.expired. Slack webhooks are automatically converted to Block Kit format.

Will I be notified when approaching my monthly limit?

Yes. Alert emails are automatically sent at 80%, 90%, and 100% of your monthly limit. Each threshold triggers only one alert per month.

Billing & Plans

How do I upgrade my plan?

Go to Dashboard > Billing to change your plan. Upgrades take effect immediately.

Can I cancel anytime?

Yes. Downgrade to Free or cancel your subscription from the Billing page. No cancellation fees.

What is the Enterprise Pro plan?

Starting at $1,499/month with dedicated infrastructure, unlimited PDF generation, SLA, and dedicated support. Pricing is based on your usage scale.

Other

What is your uptime guarantee?

We target 99.9% uptime with production-grade infrastructure and automated monitoring. Enterprise Pro plans include an SLA.

How does support work?

Free-Basic: email support. Standard: priority email. Enterprise Pro: dedicated support. Contact us at funbrew.tech.

Can I store PDFs in my own S3 bucket?

Yes. Enterprise plans and above support auto-upload to S3-compatible storage (AWS S3, Wasabi, etc.). Configure in Dashboard > S3 Storage.

Can I generate PDFs in bulk?

Yes. Standard plans and above support the batch API. Send up to 100 HTML/URL items in a single API call for async processing. Track progress with the batch ID.

Have more questions? Feel free to contact us.