Custom Fonts

Use your brand's fonts in generated images.

Available System Fonts

All plans include these preloaded fonts:

Font	Style	Best For
Inter	Sans-serif	General use, UI
Roboto	Sans-serif	Google/Android aesthetic
SF Pro	Sans-serif	Apple aesthetic
Lora	Serif	Editorial, elegant
JetBrains Mono	Monospace	Code, technical

Using System Fonts

Specify font in your request:

{
  "title": "Your Title",
  "font": "inter",
  "theme": "dark"
}

Available font values:

• inter (default)
• roboto
• sf-pro
• lora
• mono

Custom Fonts (Pro/Business)

Upload your own fonts for brand consistency.

Supported Formats

• .ttf (TrueType)
• .otf (OpenType)
• .woff (Web Open Font Format)
• .woff2 (Web Open Font Format 2)

Font Upload API

curl -X POST https://ogimageapi.io/api/fonts \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "font=@/path/to/YourFont.ttf" \
  -F "name=your-brand-font" \
  -F "weight=400"

Using Custom Fonts

Once uploaded, reference by name:

{
  "title": "Your Title",
  "font": "your-brand-font",
  "theme": "dark"
}

Font Licensing

Important

Ensure you have proper licensing for any fonts you upload.

License Requirements

• ✅ Open source fonts (Google Fonts, etc.)
• ✅ Fonts you've purchased with server/embedding license
• ✅ Custom fonts created for your brand
• ❌ Desktop-only licensed fonts
• ❌ Fonts without embedding rights

Recommended Free Fonts

Font	Source	Style
Plus Jakarta Sans	Google Fonts	Modern sans
Outfit	Google Fonts	Geometric sans
Space Grotesk	Google Fonts	Tech sans
Playfair Display	Google Fonts	Elegant serif
Source Code Pro	Google Fonts	Mono

Typography Best Practices

Title Typography

{
  "title_font": "your-brand-font",
  "title_weight": 700,
  "title_size": "auto"
}

• Use bold weights (600-800)
• Let auto-sizing handle responsive text
• Keep titles short for best appearance

Body/Subtitle Typography

{
  "subtitle_font": "inter",
  "subtitle_weight": 400
}

• Use regular weights (400-500)
• Highly readable fonts work best
• Consider fallbacks for longer text

Font Weight Reference

Weight	Name	Use Case
100	Thin	Decorative only
200	Extra Light	Decorative
300	Light	Subtle text
400	Regular	Body text
500	Medium	Emphasis
600	Semi Bold	Subheadings
700	Bold	Headings
800	Extra Bold	Strong headings
900	Black	Impact

Multiple Font Weights

Upload the same font with different weights:

# Regular
curl -X POST /api/fonts \
  -F "font=@BrandFont-Regular.ttf" \
  -F "name=brand-regular" \
  -F "weight=400"

# Bold
curl -X POST /api/fonts \
  -F "font=@BrandFont-Bold.ttf" \
  -F "name=brand-bold" \
  -F "weight=700"

Use in requests:

{
  "title": "Bold Title",
  "title_font": "brand-bold",
  "subtitle": "Regular subtitle",
  "subtitle_font": "brand-regular"
}

Font Management

List Your Fonts

curl https://ogimageapi.io/api/fonts \
  -H "X-API-Key: YOUR_API_KEY"

Delete a Font

curl -X DELETE https://ogimageapi.io/api/fonts/font-name \
  -H "X-API-Key: YOUR_API_KEY"

Troubleshooting

Font Not Rendering

1. Check font name is exact match
2. Verify font was uploaded successfully
3. Ensure font file isn't corrupted

Poor Quality Text

1. Use appropriate font weight
2. Check font supports required characters
3. Try a different font format (.ttf vs .woff2)

Missing Characters

Some fonts don't include all characters. Check that your font supports:

• Special characters (é, ñ, etc.)
• Numbers
• Punctuation

Font Limits

Plan	Max Custom Fonts
Free	0 (system fonts only)
Pro	5
Business	20