File Naming Conventions
Ads Uploader uses intelligent file naming detection to automatically organize and associate your media files, saving time and ensuring optimal ad delivery.
Key Features
Thumbnail Association
Automatically link custom thumbnail images to your videos using the _thumbnail suffix.
Example:
summer_sale.mp4
summer_sale_thumbnail.jpg
Aspect Ratio Variations
Upload up to five aspect ratios per ad and Ads Uploader will route each one to the Meta placements it suits.
Example:
| File Name | Ratio | Best For |
|---|---|---|
brand_video_1x1.mp4 | 1:1 | Facebook & Instagram Feed |
brand_video_4x5.mp4 | 4:5 | Threads, vertical feed slots |
brand_video_9x16.mp4 | 9:16 | Stories, Reels |
brand_video_16x9.mp4 | 16:9 | In-Stream Video, Right Column |
brand_video_1.91x1.mp4 | 1.91:1 | Wide placements, Marketplace |
The legacy _vertical and _horizontal suffixes still work and map to 9x16 and 16x9.
Variation Grouping
Group multiple creative variations for organized ad set creation and A/B testing using custom identifiers.
Example:
| Files | Grouped As | Purpose |
|---|---|---|
video1-hook1.mp4video1-hook2.mp4video1-hook3.mp4 | Ad Set: "video1" | Test different opening hooks |
offer-discount.mp4offer-bonus.mp4offer-trial.mp4 | Ad Set: "offer" | Test different value props |
Quick Reference
| Feature | Suffix/Pattern | Example |
|---|---|---|
| Thumbnail | _thumbnail | video_thumbnail.jpg |
| 1:1 (square) | _1x1 | video_1x1.mp4 |
| 4:5 (portrait) | _4x5 | video_4x5.mp4 |
| 9:16 (story) | _9x16 (or _vertical) | video_9x16.mp4 |
| 16:9 (landscape) | _16x9 (or _horizontal) | video_16x9.mp4 |
| 1.91:1 (wide) | _1.91x1, _191x100, _19x10 | video_1.91x1.mp4 |
| Variations | Custom identifier | video-v1.mp4, video-v2.mp4 |
The ratio token can also appear at the start (1x1_video.mp4) or in the middle (video_1x1_v2.mp4) of the filename.
Customization
These are the default patterns. You can change the delimiter (e.g. use - instead of _) and other detection settings in User Defaults > Placements.