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
_thumbnailsuffix (lowercase, with underscore) - Use a supported image format
Examples
✅ Correct Naming
| Video File | Thumbnail File | ✓ |
|---|---|---|
summer_sale.mp4 | summer_sale_thumbnail.jpg | Matched |
product_demo_v1.mov | product_demo_v1_thumbnail.png | Matched |
ad_creative_001.mp4 | ad_creative_001_thumbnail.webp | Matched |
❌ Won't Be Detected
| Video File | Thumbnail File | Issue |
|---|---|---|
summer_sale.mp4 | summer_thumb.jpg | Base name doesn't match |
video1.mp4 | video1-thumbnail.png | Use underscore, not hyphen |
promo.mp4 | promo_Thumbnail.jpg | Case matters: use lowercase |
Supported Formats
Video Formats
- MP4
- MOV
Thumbnail Formats
- PNG (recommended for quality)
- JPG/JPEG
- WebP
Custom Thumbnail Naming
The default pattern uses _thumbnail as the suffix, but you can customize both the separator and suffix in User Defaults.
Configurable Options
| Setting | Default | Description |
|---|---|---|
| Separator | _ | Character between filename and suffix |
| Suffix | thumbnail | The word that identifies thumbnail files |
Custom Examples
| Separator | Suffix | Video File | Thumbnail File |
|---|---|---|---|
_ | thumbnail | promo.mp4 | promo_thumbnail.jpg |
- | thumb | promo.mp4 | promo-thumb.jpg |
_ | cover | promo.mp4 | promo_cover.jpg |
Configure these settings in Account > Defaults > Media Variants.