Skip to main content
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
Premium multiline text overlay with soft shadow

​
Core parameters

ParamValueDefault
textURL-encoded text (max 500 chars). Use %0A for line breaks.—
textColorHex color (#fff, #ffffff, or with alpha #ffffff80).#ffffff
textSizeFont size in pixels (8–256).48
textPositiontop-left, top-center, top-right, center, bottom-left, bottom-center, bottom-right.bottom-center
textFontsans, serif, mono, or aliases like arial, georgia, courier.sans
textAlignHorizontal 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
textShadowDrop shadow as dx,dy,blur,#color (e.g. 2,2,4,#000000aa).none
textBgOptional 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

ParamValue
textFontUrlPublic HTTPS URL to a WOFF/WOFF2/TTF/OTF file embedded at render time.
textWidthMax text block width in pixels (enables wrapping).
textStroke / textStrokeColorOutline width and hex colour.
textLetterSpacingLetter 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/cvly_pub_.../{fileId}?preset=og-card&text=My+latest+post" />
For image watermarks (second raster layer), see Watermarks.