Origin Configuration

Default Render Params

Default origin params are query parameters that are added to the origin request behind the scenes and are not publicly visible. This makes them the perfect candidate for passing “secret” values to your origin server.

Default origin params will not overwrite any matching params in the render url. For instance, if you have utm_source=unknown as a default origin parameter and your render url contains a utm_source value:

https://cdn.opengraphimage.com/key/template?utm_source=google&s=signature

Then the URL that is requested from your origin would be:

<origin base url>/template?utm_source=google

However, if your render URL does not include a utm_source value:

https://cdn.opengraphimage.com/key/template?s=signature

Then the URL that is requested from your origin would be:

<origin base url>/template?utm_source=unknown

Revalidation & cache freshness

• revalidation — blocking (default) re-renders on the request when a cached image passes its TTL (fresh at time of open; use for email). background serves the existing image immediately and re-renders behind the request (use for OG cards).
• max_age — cache TTL in seconds (default 86400). Set to null to disable the TTL entirely (non-expiring): the image is served until you change the template/config, which invalidates it explicitly. Pairs naturally with revalidation: background for OG cards.