Generate Certificates at Scale: A Developer Guide
Build a PDF certificate generator that scales to thousands of certificates. Complete guide with templates, API examples, and batch generation.
By LightningPDF Team · · 7 min read
TL;DR: Generate professional PDF certificates at scale using HTML templates and LightningPDF's batch API. Design once, generate thousands with dynamic names, dates, and credentials.
Generate Certificates at Scale: A Developer Guide
Course completions, professional credentials, event attendance, employee awards -- certificates pile up fast. When you need to issue ten, doing them by hand is feasible. When you need to issue ten thousand after a conference or at the end of a training program, manual generation is not an option.
PDF certificate generation at scale is the process of programmatically creating individualized certificate documents by merging recipient-specific data (names, dates, credentials) with an HTML template and converting each instance to a print-ready PDF via an API.
Here's how to build a certificate generator that handles ten certificates or ten thousand. You will design a certificate template in HTML and CSS, generate individual certificates through the LightningPDF API, implement batch generation for bulk issuance, and add customization options like QR codes, custom fonts, and logos.
Why Certificate Generation Is Hard at Scale
The Manual Approach Breaks Down Fast
Creating certificates manually in a tool like Canva, PowerPoint, or Google Slides involves opening the template, typing the recipient's name, adjusting alignment if the name is longer or shorter than the placeholder, changing the date, exporting to PDF, renaming the file, and repeating. 500 certificates at 3-5 minutes each? That's 25-40 hours -- an entire work week lost to repetitive data entry.
Common Problems with DIY Solutions
Teams that outgrow manual creation often build ad-hoc solutions using mail merge tools, headless browsers, or image manipulation libraries. These approaches break down at scale:
- Font rendering inconsistencies: A certificate that looks perfect on your machine renders differently on the server because the font is not installed.
- Alignment drift: When recipient names vary in length, centered text shifts and breaks the visual balance of the design.
- Image quality degradation: Logos and signatures lose quality during format conversions.
- Slow generation: Headless browser solutions take 2-5 seconds per certificate. At 5,000 certificates, that is 4-7 hours of processing.
- No verification: Recipients have no way to verify that a certificate is authentic.
What You Need from a Certificate System
A production-grade certificate generator should support:
- Dynamic text: Names, dates, course titles, credential IDs that change per recipient
- Consistent rendering: The same output regardless of where the generation runs
- Batch processing: Generate thousands of certificates efficiently
- Quality output: Print-ready PDFs with crisp text and high-resolution images
- Verification: QR codes or unique URLs that let third parties verify authenticity
Designing a Certificate Template
The most flexible approach to certificate design is HTML and CSS. You get full control over layout, typography, and decoration while keeping the template easy to modify and version-control. For a deeper introduction to HTML-to-PDF conversion, see our HTML-to-PDF complete guide.
A Complete Certificate Template
Here is a professional certificate template with a decorative border, centered layout, and spaces for dynamic content:
<!DOCTYPE html>
<html>
<head>
<style>
@page {
size: A4 landscape;
margin: 0;
}
* { margin: 0; padding: 0; box-sizing: border-box; }
body {
font-family: 'Georgia', 'Times New Roman', serif;
color: #1a1a2e;
width: 297mm;
height: 210mm;
display: flex;
align-items: center;
justify-content: center;
}
.certificate {
width: 267mm;
height: 180mm;
border: 3px solid #c9a84c;
padding: 20mm;
position: relative;
text-align: center;
display: flex;
flex-direction: column;
align-items: center;
justify-content: center;
}
/* Decorative double border */
.certificate::before {
content: '';
position: absolute;
top: 4mm;
left: 4mm;
right: 4mm;
bottom: 4mm;
border: 1px solid #c9a84c;
}
/* Corner decorations */
.corner {
position: absolute;
width: 30mm;
height: 30mm;
border-color: #c9a84c;
border-style: solid;
}
.corner.tl { top: 8mm; left: 8mm; border-width: 2px 0 0 2px; }
.corner.tr { top: 8mm; right: 8mm; border-width: 2px 2px 0 0; }
.corner.bl { bottom: 8mm; left: 8mm; border-width: 0 0 2px 2px; }
.corner.br { bottom: 8mm; right: 8mm; border-width: 0 2px 2px 0; }
.org-logo {
width: 60px;
height: 60px;
margin-bottom: 10mm;
}
.heading {
font-size: 14px;
text-transform: uppercase;
letter-spacing: 6px;
color: #c9a84c;
margin-bottom: 5mm;
}
.title {
font-size: 36px;
font-weight: 700;
color: #1a1a2e;
margin-bottom: 8mm;
letter-spacing: 3px;
text-transform: uppercase;
}
.subtitle {
font-size: 14px;
color: #64748b;
margin-bottom: 6mm;
}
.recipient-name {
font-size: 32px;
font-weight: 700;
color: #4F46E5;
font-family: 'Georgia', serif;
font-style: italic;
margin-bottom: 6mm;
border-bottom: 2px solid #c9a84c;
padding-bottom: 4mm;
display: inline-block;
}
.description {
font-size: 14px;
color: #475569;
max-width: 180mm;
line-height: 1.6;
margin-bottom: 10mm;
}
.signatures {
display: flex;
justify-content: space-between;
width: 180mm;
margin-top: auto;
}
.signature {
text-align: center;
width: 70mm;
}
.signature .line {
border-top: 1px solid #94a3b8;
margin-bottom: 2mm;
margin-top: 10mm;
}
.signature .name { font-size: 13px; font-weight: 600; }
.signature .role { font-size: 11px; color: #94a3b8; }
.cert-id {
position: absolute;
bottom: 12mm;
right: 15mm;
font-size: 9px;
color: #94a3b8;
font-family: 'Courier New', monospace;
}
.qr-code {
position: absolute;
bottom: 12mm;
left: 15mm;
width: 20mm;
height: 20mm;
}
</style>
</head>
<body>
<div class="certificate">
<div class="corner tl"></div>
<div class="corner tr"></div>
<div class="corner bl"></div>
<div class="corner br"></div>
<img class="org-logo" src="https://example.com/logo.png" alt="Logo">
<div class="heading">Academy of Excellence</div>
<div class="title">Certificate of Completion</div>
<div class="subtitle">This is proudly presented to</div>
<div class="recipient-name">Jane Alexandra Smith</div>
<div class="description">
For successfully completing the <strong>Advanced Data Engineering</strong>
program consisting of 120 hours of instruction and practical projects,
demonstrating proficiency in distributed systems, data pipelines, and
cloud architecture.
</div>
<div class="signatures">
<div class="signature">
<div class="line"></div>
<div class="name">Dr. Robert Chen</div>
<div class="role">Program Director</div>
</div>
<div class="signature">
<div class="line"></div>
<div class="name">Sarah Williams</div>
<div class="role">Chief Academic Officer</div>
</div>
</div>
<img class="qr-code" src="https://api.qrserver.com/v1/create-qr-code/?size=150x150&data=https://verify.example.com/cert/CERT-2026-00042" alt="QR">
<div class="cert-id">CERT-2026-00042 | Issued: February 23, 2026</div>
</div>
</body>
</html>
Key design considerations for certificate templates:
- Landscape orientation: Most certificates use landscape A4 or Letter. Set this with
@page { size: A4 landscape; }. - Centered layout: Flexbox centering ensures the content stays balanced regardless of text length.
- Decorative borders: CSS pseudo-elements and positioned divs create elegant borders without images.
- Dynamic content areas: The recipient name, course title, dates, and certificate ID are all placeholders that your code will replace.
- Print readiness: Zero page margins with the design's own padding ensures the certificate fills the page correctly.
For tips on keeping content from splitting across pages in multi-page documents, see our page break troubleshooting guide.
Generating a Single Certificate
With the template ready, generating a single certificate is a matter of substituting the dynamic values and sending the HTML to the API. Sign up for a free account to get your API key -- the free tier includes 50 PDFs per month.
curl
curl -X POST https://api.lightningpdf.dev/api/v1/pdf/generate \
-H "X-API-Key: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"html": "<!DOCTYPE html><html><head><style>@page{size:A4 landscape;margin:0}body{font-family:Georgia,serif;display:flex;align-items:center;justify-content:center;width:297mm;height:210mm}.cert{width:267mm;height:180mm;border:3px solid #c9a84c;padding:20mm;text-align:center;display:flex;flex-direction:column;align-items:center;justify-content:center}.title{font-size:36px;font-weight:700;letter-spacing:3px;text-transform:uppercase;margin-bottom:8mm}.name{font-size:32px;color:#4F46E5;font-style:italic;border-bottom:2px solid #c9a84c;padding-bottom:4mm;margin:6mm 0}.desc{font-size:14px;color:#475569;max-width:180mm;line-height:1.6}</style></head><body><div class=\"cert\"><div style=\"font-size:14px;text-transform:uppercase;letter-spacing:6px;color:#c9a84c;margin-bottom:5mm\">Academy of Excellence</div><div class=\"title\">Certificate of Completion</div><div style=\"font-size:14px;color:#64748b;margin-bottom:6mm\">This is proudly presented to</div><div class=\"name\">Jane Alexandra Smith</div><div class=\"desc\">For completing the Advanced Data Engineering program (120 hours).</div><div style=\"font-size:9px;color:#94a3b8;margin-top:auto\">CERT-2026-00042 | February 23, 2026</div></div></body></html>",
"options": {
"format": "A4",
"landscape": true,
"print_background": true
}
}'
Python
import requests
import base64
API_URL = "https://api.lightningpdf.dev/api/v1/pdf/generate"
API_KEY = "your-api-key"
CERTIFICATE_TEMPLATE = """<!DOCTYPE html>
<html><head><style>
@page {{ size: A4 landscape; margin: 0; }}
* {{ margin: 0; padding: 0; box-sizing: border-box; }}
body {{
font-family: Georgia, 'Times New Roman', serif;
color: #1a1a2e;
width: 297mm; height: 210mm;
display: flex; align-items: center; justify-content: center;
}}
.certificate {{
width: 267mm; height: 180mm;
border: 3px solid #c9a84c;
padding: 20mm; position: relative;
text-align: center;
display: flex; flex-direction: column;
align-items: center; justify-content: center;
}}
.certificate::before {{
content: ''; position: absolute;
top: 4mm; left: 4mm; right: 4mm; bottom: 4mm;
border: 1px solid #c9a84c;
}}
.heading {{
font-size: 14px; text-transform: uppercase;
letter-spacing: 6px; color: #c9a84c; margin-bottom: 5mm;
}}
.title {{
font-size: 36px; font-weight: 700;
letter-spacing: 3px; text-transform: uppercase;
margin-bottom: 8mm;
}}
.subtitle {{ font-size: 14px; color: #64748b; margin-bottom: 6mm; }}
.recipient-name {{
font-size: 32px; font-weight: 700;
color: #4F46E5; font-style: italic;
border-bottom: 2px solid #c9a84c;
padding-bottom: 4mm; margin-bottom: 6mm;
display: inline-block;
}}
.description {{
font-size: 14px; color: #475569;
max-width: 180mm; line-height: 1.6; margin-bottom: 10mm;
}}
.signatures {{
display: flex; justify-content: space-between;
width: 180mm; margin-top: auto;
}}
.signature {{ text-align: center; width: 70mm; }}
.signature .line {{
border-top: 1px solid #94a3b8;
margin-bottom: 2mm; margin-top: 10mm;
}}
.signature .name {{ font-size: 13px; font-weight: 600; }}
.signature .role {{ font-size: 11px; color: #94a3b8; }}
.cert-id {{
position: absolute; bottom: 12mm; right: 15mm;
font-size: 9px; color: #94a3b8;
font-family: 'Courier New', monospace;
}}
.qr-code {{
position: absolute; bottom: 12mm; left: 15mm;
width: 20mm; height: 20mm;
}}
</style></head><body>
<div class="certificate">
<div class="heading">{org_name}</div>
<div class="title">{cert_title}</div>
<div class="subtitle">This is proudly presented to</div>
<div class="recipient-name">{recipient_name}</div>
<div class="description">{description}</div>
<div class="signatures">
<div class="signature">
<div class="line"></div>
<div class="name">{signer_1_name}</div>
<div class="role">{signer_1_role}</div>
</div>
<div class="signature">
<div class="line"></div>
<div class="name">{signer_2_name}</div>
<div class="role">{signer_2_role}</div>
</div>
</div>
<img class="qr-code"
src="https://api.qrserver.com/v1/create-qr-code/?size=150x150&data={verify_url}"
alt="Verify">
<div class="cert-id">{cert_id} | Issued: {issue_date}</div>
</div>
</body></html>"""
def generate_certificate(recipient):
"""Generate a single PDF certificate for a recipient."""
html = CERTIFICATE_TEMPLATE.format(
org_name=recipient.get("org_name", "Academy of Excellence"),
cert_title=recipient.get("cert_title", "Certificate of Completion"),
recipient_name=recipient["name"],
description=recipient["description"],
signer_1_name=recipient.get("signer_1_name", "Dr. Robert Chen"),
signer_1_role=recipient.get("signer_1_role", "Program Director"),
signer_2_name=recipient.get("signer_2_name", "Sarah Williams"),
signer_2_role=recipient.get("signer_2_role", "Chief Academic Officer"),
verify_url=f"https://verify.example.com/cert/{recipient['cert_id']}",
cert_id=recipient["cert_id"],
issue_date=recipient["issue_date"]
)
response = requests.post(
API_URL,
headers={
"X-API-Key": API_KEY,
"Content-Type": "application/json"
},
json={
"html": html,
"options": {
"format": "A4",
"landscape": True,
"print_background": True
}
}
)
if response.status_code == 200:
result = response.json()
pdf_bytes = base64.b64decode(result["data"]["pdf"])
filename = f"cert_{recipient['cert_id']}.pdf"
with open(filename, "wb") as f:
f.write(pdf_bytes)
print(f"Generated {filename} for {recipient['name']} "
f"in {result['data']['generation_time_ms']}ms")
return pdf_bytes
else:
raise Exception(f"API error {response.status_code}: {response.text}")
# Usage
generate_certificate({
"name": "Jane Alexandra Smith",
"cert_id": "CERT-2026-00042",
"issue_date": "February 23, 2026",
"description": (
"For successfully completing the <strong>Advanced Data Engineering</strong> "
"program consisting of 120 hours of instruction and practical projects, "
"demonstrating proficiency in distributed systems, data pipelines, "
"and cloud architecture."
)
})
Node.js
For Node.js integration, the pattern mirrors the Python example. Our Node.js PDF generation guide covers additional patterns including streaming responses and Express middleware.
const fs = require('fs');
const API_URL = 'https://api.lightningpdf.dev/api/v1/pdf/generate';
const API_KEY = 'your-api-key';
function buildCertificateHtml(recipient) {
return `<!DOCTYPE html>
<html><head><style>
@page { size: A4 landscape; margin: 0; }
body { font-family: Georgia, serif; width: 297mm; height: 210mm;
display: flex; align-items: center; justify-content: center; }
.cert { width: 267mm; height: 180mm; border: 3px solid #c9a84c;
padding: 20mm; text-align: center; position: relative;
display: flex; flex-direction: column;
align-items: center; justify-content: center; }
.cert::before { content: ''; position: absolute;
top: 4mm; left: 4mm; right: 4mm; bottom: 4mm;
border: 1px solid #c9a84c; }
.heading { font-size: 14px; text-transform: uppercase;
letter-spacing: 6px; color: #c9a84c; margin-bottom: 5mm; }
.title { font-size: 36px; font-weight: 700; letter-spacing: 3px;
text-transform: uppercase; margin-bottom: 8mm; }
.name { font-size: 32px; color: #4F46E5; font-style: italic;
font-weight: 700; border-bottom: 2px solid #c9a84c;
padding-bottom: 4mm; margin: 6mm 0; display: inline-block; }
.desc { font-size: 14px; color: #475569; max-width: 180mm;
line-height: 1.6; margin-bottom: 10mm; }
.signatures { display: flex; justify-content: space-between;
width: 180mm; margin-top: auto; }
.sig { text-align: center; width: 70mm; }
.sig .line { border-top: 1px solid #94a3b8; margin-bottom: 2mm; margin-top: 10mm; }
.sig .sname { font-size: 13px; font-weight: 600; }
.sig .role { font-size: 11px; color: #94a3b8; }
.cert-id { position: absolute; bottom: 12mm; right: 15mm;
font-size: 9px; color: #94a3b8; font-family: 'Courier New', monospace; }
</style></head><body>
<div class="cert">
<div class="heading">${recipient.orgName || 'Academy of Excellence'}</div>
<div class="title">${recipient.certTitle || 'Certificate of Completion'}</div>
<div style="font-size:14px;color:#64748b;margin-bottom:6mm">This is proudly presented to</div>
<div class="name">${recipient.name}</div>
<div class="desc">${recipient.description}</div>
<div class="signatures">
<div class="sig">
<div class="line"></div>
<div class="sname">${recipient.signer1Name || 'Dr. Robert Chen'}</div>
<div class="role">${recipient.signer1Role || 'Program Director'}</div>
</div>
<div class="sig">
<div class="line"></div>
<div class="sname">${recipient.signer2Name || 'Sarah Williams'}</div>
<div class="role">${recipient.signer2Role || 'Chief Academic Officer'}</div>
</div>
</div>
<div class="cert-id">${recipient.certId} | Issued: ${recipient.issueDate}</div>
</div>
</body></html>`;
}
async function generateCertificate(recipient) {
const html = buildCertificateHtml(recipient);
const response = await fetch(API_URL, {
method: 'POST',
headers: {
'X-API-Key': API_KEY,
'Content-Type': 'application/json'
},
body: JSON.stringify({
html,
options: { format: 'A4', landscape: true, print_background: true }
})
});
if (!response.ok) {
throw new Error(`API error: ${response.status} ${await response.text()}`);
}
const result = await response.json();
const pdfBuffer = Buffer.from(result.data.pdf, 'base64');
const filename = `cert_${recipient.certId}.pdf`;
fs.writeFileSync(filename, pdfBuffer);
console.log(`Generated ${filename} for ${recipient.name} in ${result.data.generation_time_ms}ms`);
return pdfBuffer;
}
// Usage
generateCertificate({
name: 'Jane Alexandra Smith',
certId: 'CERT-2026-00042',
issueDate: 'February 23, 2026',
description: 'For successfully completing the <strong>Advanced Data Engineering</strong> program consisting of 120 hours of instruction and practical projects.'
});
Batch Generation at Scale
Generating certificates one at a time works for small batches, but when you need to issue thousands of certificates after a course ends or a conference wraps up, the batch API cuts total processing time and simplifies your code.
Python Batch Generation
import requests
import base64
import zipfile
import io
API_URL = "https://api.lightningpdf.dev/api/v1/pdf/batch"
API_KEY = "your-api-key"
def generate_certificates_batch(recipients, batch_size=100):
"""Generate certificates in batches of up to 100."""
all_pdfs = []
for i in range(0, len(recipients), batch_size):
batch = recipients[i:i + batch_size]
items = []
for recipient in batch:
html = CERTIFICATE_TEMPLATE.format(
org_name=recipient.get("org_name", "Academy of Excellence"),
cert_title=recipient.get("cert_title", "Certificate of Completion"),
recipient_name=recipient["name"],
description=recipient["description"],
signer_1_name=recipient.get("signer_1_name", "Dr. Robert Chen"),
signer_1_role=recipient.get("signer_1_role", "Program Director"),
signer_2_name=recipient.get("signer_2_name", "Sarah Williams"),
signer_2_role=recipient.get("signer_2_role", "Chief Academic Officer"),
verify_url=f"https://verify.example.com/cert/{recipient['cert_id']}",
cert_id=recipient["cert_id"],
issue_date=recipient["issue_date"]
)
items.append({
"html": html,
"options": {
"format": "A4",
"landscape": True,
"print_background": True
},
"metadata": {
"cert_id": recipient["cert_id"],
"recipient": recipient["name"]
}
})
response = requests.post(
API_URL,
headers={
"X-API-Key": API_KEY,
"Content-Type": "application/json"
},
json={"items": items}
)
if response.status_code == 200:
result = response.json()
print(f"Batch {i // batch_size + 1}: "
f"queued {result['data']['total']} certificates")
all_pdfs.append(result)
else:
print(f"Batch {i // batch_size + 1} failed: {response.status_code}")
return all_pdfs
def package_as_zip(pdf_files, output_path="certificates.zip"):
"""Package all generated certificate PDFs into a zip archive."""
with zipfile.ZipFile(output_path, "w", zipfile.ZIP_DEFLATED) as zf:
for cert_id, pdf_bytes in pdf_files:
zf.writestr(f"{cert_id}.pdf", pdf_bytes)
print(f"Packaged {len(pdf_files)} certificates into {output_path}")
# Example: Generate certificates for 500 course completers
import csv
def load_recipients_from_csv(csv_path):
recipients = []
with open(csv_path, "r") as f:
reader = csv.DictReader(f)
for i, row in enumerate(reader, start=1):
recipients.append({
"name": row["full_name"],
"cert_id": f"CERT-2026-{i:05d}",
"issue_date": "February 23, 2026",
"description": (
f"For successfully completing the "
f"<strong>{row['course_name']}</strong> program."
)
})
return recipients
recipients = load_recipients_from_csv("completers.csv")
generate_certificates_batch(recipients)
Performance at Scale
Here is what to expect at different volumes using the LightningPDF batch API:
| Volume | Estimated Time | API Calls | Plan Required |
|---|---|---|---|
| 50 certificates | ~5 seconds | 1 batch call | Free tier (50/mo) |
| 500 certificates | ~50 seconds | 5 batch calls | Starter ($9/mo, 2,000/mo) |
| 2,000 certificates | ~3 minutes | 20 batch calls | Starter ($9/mo, 2,000/mo) |
| 10,000 certificates | ~15 minutes | 100 batch calls | Pro ($29/mo, 10,000/mo) |
Compare this to a self-hosted Puppeteer solution at 2-3 seconds per certificate: 10,000 certificates would take 5-8 hours instead of 15 minutes.
Customization Options
Custom Fonts
Certificates often use decorative or brand-specific fonts. Embed them with @font-face to ensure consistent rendering:
<style>
@font-face {
font-family: 'Playfair Display';
src: url('https://fonts.gstatic.com/s/playfairdisplay/v30/nuFlD-vYSZviVYUb_rj3ij__anPXBYf9lWAe.woff2')
format('woff2');
font-weight: 700;
font-style: normal;
}
@font-face {
font-family: 'Great Vibes';
src: url('https://fonts.gstatic.com/s/greatvibes/v18/RWmMoKWR9v4ksMfaWd_JN-XCg6UKDXlq.woff2')
format('woff2');
}
.recipient-name {
font-family: 'Great Vibes', cursive;
font-size: 42px;
}
.title {
font-family: 'Playfair Display', Georgia, serif;
}
</style>
Use absolute URLs for font files. Relative paths and local file references will not work in a cloud rendering environment. For more on font handling in PDFs, our HTML-to-PDF guide covers the common pitfalls.
Logo and Signature Embedding
For maximum reliability, embed logos and signatures as base64 data URIs rather than linking to external URLs:
import base64
def embed_image(image_path):
with open(image_path, "rb") as f:
data = base64.b64encode(f.read()).decode()
ext = image_path.split(".")[-1]
mime = {"png": "image/png", "jpg": "image/jpeg", "svg": "image/svg+xml"}
return f"data:{mime.get(ext, 'image/png')};base64,{data}"
logo_uri = embed_image("company_logo.png")
signature_uri = embed_image("director_signature.png")
# Use in template
html = f"""
<img class="org-logo" src="{logo_uri}" alt="Logo">
...
<img class="signature-img" src="{signature_uri}" alt="Signature"
style="height: 15mm; margin-bottom: -8mm;">
"""
QR Codes for Verification
QR codes let recipients and third parties verify that a certificate is authentic by scanning the code and visiting a verification URL:
# Option 1: Use a QR code API (no dependencies)
qr_url = (
f"https://api.qrserver.com/v1/create-qr-code/"
f"?size=150x150&data=https://verify.example.com/cert/{cert_id}"
)
html += f'<img class="qr-code" src="{qr_url}" alt="Verify">'
# Option 2: Generate QR codes locally with qrcode library
import qrcode
import io
def generate_qr_base64(data):
qr = qrcode.make(data)
buffer = io.BytesIO()
qr.save(buffer, format="PNG")
return base64.b64encode(buffer.getvalue()).decode()
qr_data = generate_qr_base64(f"https://verify.example.com/cert/{cert_id}")
html += f'<img class="qr-code" src="data:image/png;base64,{qr_data}" alt="Verify">'
Unique Certificate IDs
Generate tamper-resistant certificate IDs that are hard to guess but easy to look up:
import hashlib
import secrets
def generate_cert_id(recipient_name, course_id, issue_date):
"""Generate a unique, verifiable certificate ID."""
salt = secrets.token_hex(8)
payload = f"{recipient_name}:{course_id}:{issue_date}:{salt}"
hash_value = hashlib.sha256(payload.encode()).hexdigest()[:12].upper()
return f"CERT-{hash_value}"
cert_id = generate_cert_id("Jane Smith", "ADV-DATA-ENG", "2026-02-23")
# e.g., CERT-3A7F9B2E1C04
LightningPDF vs Alternatives for Certificate Generation
| Feature | LightningPDF | Puppeteer (Self-Hosted) | DocRaptor | CraftMyPDF |
|---|---|---|---|---|
| Speed per certificate | <100ms (native) | 2-3 seconds | 2-5 seconds | 1-2 seconds |
| Batch API | 100 per call | Manual loop | Not available | Not available |
| 10K certs generation time | ~15 minutes | 5-8 hours | 6-14 hours | 3-6 hours |
| Landscape support | Full | Full | Full | Limited |
| Custom fonts | @font-face URLs | System + @font-face | @font-face | Upload only |
| Template marketplace | Certificate templates available | None | None | Some templates |
| Monthly cost (2K certs) | $9 (Starter) | ~$200 infra | $35 | $29 |
| Free tier | 50/mo | Free (infra costs) | 5/mo | 100/mo |
For in-depth comparisons, see LightningPDF vs Puppeteer, LightningPDF vs DocRaptor, and LightningPDF vs CraftMyPDF. Our complete API comparison guide benchmarks all seven major PDF APIs.
Building a Verification System
A certificate is only as valuable as its verifiability. Here is a minimal verification endpoint that pairs with the QR codes on your certificates:
from flask import Flask, jsonify, abort
app = Flask(__name__)
@app.route("/cert/<cert_id>")
def verify_certificate(cert_id):
# Look up the certificate in your database
cert = db.query("SELECT * FROM certificates WHERE cert_id = %s", cert_id)
if not cert:
abort(404)
return jsonify({
"valid": True,
"cert_id": cert["cert_id"],
"recipient": cert["recipient_name"],
"course": cert["course_name"],
"issued": cert["issue_date"],
"issuer": cert["org_name"]
})
When a third party (an employer, a university, a licensing board) scans the QR code on the certificate, they are taken to this endpoint, which confirms the certificate's authenticity and displays the details.
Getting Started
- Create a free LightningPDF account -- 50 certificates per month, no credit card required.
- Copy your API key from the dashboard.
- Use the HTML template and Python or Node.js code above to generate your first certificate.
- Browse the template marketplace for pre-built certificate designs, or build your own in the visual designer.
- Scale up with batch generation when you need to issue hundreds or thousands at once.
- Check pricing when you are ready to move beyond the free tier: Starter at $9/month covers 2,000 certificates, Pro at $29/month handles 10,000.
The full API documentation covers additional options including custom page sizes, margins, headers and footers, and watermark overlays.
Frequently Asked Questions
How do I generate PDF certificates at scale?
Use LightningPDF's batch API to generate up to 100 certificates per API call. Load your recipient list from a CSV or database, merge each name and credential into your HTML template, and send the batch. Ten thousand certificates take approximately 15 minutes with the batch API, compared to 5-8 hours with self-hosted Puppeteer.
Can I add QR codes to certificates for verification?
Yes. Embed a QR code in your certificate template using an inline image tag that points to a QR generation API or a base64-encoded image generated locally. The QR code encodes a verification URL unique to each certificate ID. When scanned, the URL resolves to your verification endpoint confirming the certificate's authenticity.
What formats and layouts does LightningPDF support for certificates?
LightningPDF supports any page size and orientation, including landscape A4 and Letter which are the standard certificate formats. You can use any CSS features including custom fonts via font-face, flexbox and grid layouts, decorative borders, embedded images, and SVG graphics. The template is standard HTML and CSS with no proprietary format.
Related Reading
- How to Auto-Generate PDF Invoices -- Invoice automation patterns
- Automate PDF Report Generation -- Data-driven report pipelines
- Best PDF Generation APIs in 2026 -- Compare all seven top PDF APIs
- Generate PDFs in Python -- Python integration guide
- Generate PDFs in Node.js -- Node.js tutorial with async patterns
- Generate PDFs in Go -- Go tutorial with template examples
- HTML to PDF: The Complete Guide -- All conversion approaches compared
- How to Fix PDF Page Breaks -- Solve layout issues in multi-page documents
- LightningPDF vs Puppeteer -- Build vs buy cost analysis
L
LightningPDF Team
Building fast, reliable PDF generation tools for developers.