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

Customization

These are the default patterns. You can customize the delimiter, suffixes, and thumbnail naming in User Defaults.

For example, if your team uses _9x16 instead of _vertical, or -thumb instead of _thumbnail, you can configure Ads Uploader to recognize your naming conventions.