Documentation

Media Uploads

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 different versions optimized for Feed, Stories, and Reels using _vertical and _horizontal suffixes.

Example:

File NameFormatBest For
brand_video.mp4Square/Feed (1:1 or 4:5)News Feed, Instagram Feed
brand_video_vertical.mp4Stories/Reels (9:16)Stories, Reels, Mobile
brand_video_horizontal.mp4In-stream (16:9)Desktop, YouTube, Watch

🎯 Variation Grouping

Group multiple creative variations for organized ad set creation and A/B testing using custom identifiers.

Example:

FilesGrouped AsPurpose
video1-hook1.mp4
video1-hook2.mp4
video1-hook3.mp4
Ad Set: "video1"Test different opening hooks
offer-discount.mp4
offer-bonus.mp4
offer-trial.mp4
Ad Set: "offer"Test different value props

Quick Reference

FeatureSuffix/PatternExample
Thumbnail_thumbnailvideo_thumbnail.jpg
Vertical (9:16)_verticalvideo_vertical.mp4
Horizontal (16:9)_horizontalvideo_horizontal.mp4
VariationsCustom identifiervideo-v1.mp4, video-v2.mp4