Why Is My Image Blurry?

Common causes and fixes for blurry renders.

Cause 1: Low Resolution Source Image

Problem: Your source image is smaller than the layer size.

Fix:

• Use higher resolution source images
• Match or exceed the template dimensions
• For a 1920×1080 template, use at least 1920×1080 images

Cause 2: Scale Factor

Problem: Using scale below 1.0 reduces quality.

Fix:

• Use scale: 1.0 or higher
• If you need smaller output, resize after downloading

{
  "scale": 1.0  // Not 0.5
}

Cause 3: Object Fit Setting

Problem: Image is being stretched with object_fit: fill.

Fix:

• Use object_fit: cover or contain
• cover — Fills area, may crop edges
• contain — Shows entire image, may have padding

{
  "layers": {
    "photo": {
      "image_url": "https://...",
      "object_fit": "cover"
    }
  }
}

Cause 4: JPEG Compression

Problem: JPEG format compresses images, reducing quality.

Fix:

• Use PNG for graphics/text
• Use WebP for better quality at smaller sizes
• JPEG is best for photographs only

Cause 5: Template Dimensions

Problem: Template itself is low resolution.

Fix:

• Check template dimensions in Editor
• Resize template to needed output size
• Don't rely on scaling up during render

Quick Checklist

• [ ] Source images ≥ template dimensions
• [ ] Scale factor ≥ 1.0
• [ ] Appropriate object_fit setting
• [ ] Correct output format
• [ ] Template has adequate dimensions

Updated on: 11/01/2026