Text Overlays

Titles, subtitles, and badges on any screenshot

Add text overlays with any Google Font. Colors auto-derive from the background for legibility, or set them explicitly. Five positioning options. Badge pills for labels like NEW, GUIDE, or VIDEO.

Core parameters

  • title — main heading text.
  • title_font — any Google Font name (DM Sans, Inter, Playfair Display, etc).
  • title_size — 24–96px font size.
  • title_color — #rrggbb or "auto" (derived from background luminance).
  • title_position — above, below, bottom-left, top-left, or overlay-bottom.
  • subtitle — secondary text with the same options as title.
  • badge — auto-styled pill label.

Free-form text overlay

  • For headlines with exact pixel positioning, gradient fill, and custom shadows, use the text_* family: text_enabled, text_content, text_x / text_y (0–1 fractional anchor), text_size, text_weight, text_color, text_gradient, text_shadow, text_font, text_align, text_max_width, text_line_height.
  • Drag the headline around the live preview in the Preset Builder to dial in placement — the builder emits API-ready JSON.

API example

Title, subtitle, badge with midnight background

curl -X POST https://screenframed.com/v1/capture \
  -H "Authorization: Bearer sf_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://stripe.com",
    "title": "Launch-ready payment pages",
    "subtitle": "The issue tracker built for speed",
    "badge": "NEW",
    "title_font": "DM Sans",
    "title_position": "above",
    "background_preset": "midnight",
    "shadow": "float",
    "padding": 80
  }'