What is a Layer?

A layer is an individual, editable element inside a Template—like text, an image, or a shape.
Templates are dynamic because their layers can be updated at render time without changing the base design.

Common layer types

• Text (titles, prices, captions)
• Image (product photos, logos, backgrounds)
• Shapes/Backgrounds (colors, decorative blocks)
• Others: QR Code, Barcode, rating stars, HTML blocks

Common layer fields (varies by layer type)
text, image_url, color, background, font_family, font_size, font_weight,
horizontal_align, vertical_align, autofit, border_*, fill, stroke,
hide, link (PDF only), x, y, rotation, width, height, object_fit.

How layers are used in the API

Create a render by sending the template ID and the layer changes you want:

curl -X POST https://api.templated.io/v1/render \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "template": "TEMPLATE_ID",
    "format": "jpg",
    "layers": {
      "title": { "text": "New Product Launch", "color": "#111111" },
      "price": { "text": "$29.99" },
      "product_img": { "image_url": "https://example.com/product.png" }
    }
  }'

Updated on: 11/01/2026