Caching - OGify | Generate beautiful Open Graph images in minutes

OGify includes a built-in caching system to improve performance by reducing redundant network requests for fonts and emojis. You can configure caching when creating a renderer.

Configuration

Memory Cache
Filesystem Cache

Fast in-memory cache with LRU eviction (default)

import { createRenderer } from '@ogify/core';

const renderer = createRenderer({
  templates: { /* ... */ },
  cache: {
    type: 'memory',
    ttl: 3600000, // 1 hour (optional)
    max: 100      // Max items (optional)
  }
});

Persistent cache stored on disk

import { createRenderer } from '@ogify/core';

const renderer = createRenderer({
  templates: { /* ... */ },
  cache: {
    type: 'filesystem',
    dir: '.cache/ogify',  // Cache directory
    ttl: 3600000,         // 1 hour (optional)
    max: 100              // Max items (optional)
  }
});

What is Cached?

Remote Fonts

Fonts downloaded from Google Fonts or other URLs are cached to avoid repeated network requests.

Emoji Assets

Emoji images from providers like Twemoji, Fluent, etc. are cached for faster rendering.

Generated Images

Rendered PNG buffers are cached by a key derived from the template ID, merged parameters, and render options. Identical requests return the cached buffer without re-rendering.

Concurrent Render Deduplication

When multiple requests arrive with the same cache key before the first render completes, OGify deduplicates them automatically. All callers share the same in-flight Promise and receive the same PNG buffer once rendering finishes. This prevents redundant Satori/Resvg work during traffic spikes or parallel page builds.

Disabling Cache

Not recommended for production environments

To disable caching completely:

const renderer = createRenderer({
  // ...
  cache: false,
});

Font LoaderUsing Google Fonts or custom fonts in your templates

​Configuration

​What is Cached?

​Concurrent Render Deduplication

​Disabling Cache

Configuration

What is Cached?

Concurrent Render Deduplication

Disabling Cache