Text overlays

Add text=… to composite typography on the resized image — ideal for Open Graph cards, social previews, and dynamic badges.

Image with a text overlay badge — Text badge — `?text=Hello+world&textSize=64&textBg=%23000000aa`.

Premium multiline text overlay with soft shadow — Editorial multiline — `?text=Summer+Sale%0A50%25+Off&textFont=serif&textLetterSpacing=6`.

Core parameters

Param	Value	Default
`text`	URL-encoded text (max 500 chars). Use `%0A` for line breaks.	—
`textColor`	Hex color (`#fff`, `#ffffff`, or with alpha `#ffffff80`).	`#ffffff`
`textSize`	Font size in pixels (8–256).	`48`
`textPosition`	`top-left`, `top-center`, `top-right`, `center`, `bottom-left`, `bottom-center`, `bottom-right`.	`bottom-center`
`textFont`	`sans`, `serif`, `mono`, or aliases like `arial`, `georgia`, `courier`.	`sans`
`textAlign`	Horizontal alignment for multiline text: `left`, `center`, `right`. Applies when `textPosition` is a horizontal center anchor (`top-center`, `center`, `bottom-center`). Corner positions anchor the text block to that corner.	`center`
`textShadow`	Drop shadow as `dx,dy,blur,#color` (e.g. `2,2,4,#000000aa`).	none
`textBg`	Optional hex background pill behind text.	none

?w=1200&h=630&text=Hello%0Aworld&textSize=64&textColor=%23ffffff&textPosition=bottom-left&textAlign=left&textShadow=2,2,4,%2300000080&textBg=%23000000aa

Advanced typography

Param	Value
`textFontUrl`	Public HTTPS URL to a WOFF/WOFF2/TTF/OTF file embedded at render time.
`textWidth`	Max text block width in pixels (enables wrapping).
`textStroke` / `textStrokeColor`	Outline width and hex colour.
`textLetterSpacing`	Letter spacing in SVG units (`-20` to `80`).

OG image pattern

Vary only the title per page while a preset locks canvas size, font, and colours:

<meta property="og:image" content="https://cdn.convertly.sh/assets-acme/{fileIdOrSlug}?preset=og-card&text=My+latest+post" />

For image watermarks (second raster layer), see Watermarks.

Getting Started

Image CDN

Media Platform

SDKs & Integrations

Resources

Core parameters

Advanced typography

OG image pattern

​Core parameters

​Advanced typography

​OG image pattern

Core parameters

Advanced typography

OG image pattern