Documentation

Media Uploads

Thumbnail Attachment

Automatically associate custom thumbnail images with your videos using intelligent file naming detection.

How It Works

When you upload a video with a matching thumbnail image (using the _thumbnail suffix), Ads Uploader automatically links them together. This custom thumbnail will be used as the preview image for your video ad across all Meta placements, giving you control over the first impression viewers see before playing your video.

Naming Format

video_file_name.mp4
video_file_name_thumbnail.png

The thumbnail file must:

  • Start with the exact same base name as the video
  • Add _thumbnail suffix (lowercase, with underscore)
  • Use a supported image format

Examples

✅ Correct Naming

Video FileThumbnail File
summer_sale.mp4summer_sale_thumbnail.jpgMatched
product_demo_v1.movproduct_demo_v1_thumbnail.pngMatched
ad_creative_001.mp4ad_creative_001_thumbnail.webpMatched

❌ Won't Be Detected

Video FileThumbnail FileIssue
summer_sale.mp4summer_thumb.jpgBase name doesn't match
video1.mp4video1-thumbnail.pngUse underscore, not hyphen
promo.mp4promo_Thumbnail.jpgCase matters: use lowercase

Supported Formats

Video Formats

  • MP4
  • MOV

Thumbnail Formats

  • PNG (recommended for quality)
  • JPG/JPEG
  • WebP