Documentation

Media Uploads

Aspect Ratio Variations

Upload different versions of your creative optimized for various placements like Feed, Stories, and Reels.

How It Works

When you upload files with matching base names and aspect ratio suffixes (_vertical or _horizontal), Ads Uploader automatically groups them as variations of the same creative. This ensures Meta serves the right format for each placement.

Overview

Meta ads appear across multiple placements with different aspect ratio requirements. By uploading variations of your creative, you ensure optimal display across all placements without cropping or letterboxing.

Naming Format

File PatternDescriptionPlacement
base_file_name.extMain creativeFeed, Square placements
base_file_name_vertical.extStories/Reels versionVertical placements
base_file_name_horizontal.extIn-stream/Desktop versionHorizontal placements

Aspect Ratio Types

Square/Feed (Base File)

  • Ratio: 1:1 or 4:5
  • Best for: News Feed, Instagram Feed
  • Example: product_launch.mp4
  • Dimensions: 1080x1080px (1:1) or 1080x1350px (4:5)

Vertical (_vertical)

  • Ratio: 9:16
  • Best for: Stories, Reels, vertical mobile feeds
  • Example: product_launch_vertical.mp4
  • Dimensions: 1080x1920px

Horizontal (_horizontal)

  • Ratio: 16:9
  • Best for: In-stream videos, desktop feeds
  • Example: product_launch_horizontal.mp4
  • Dimensions: 1920x1080px

Visual Indicators

After upload, you'll see:

  • V badge for files with vertical associations
  • H badge for files with horizontal associations
  • Grouped display showing all variations together
Aspect ratio variations confirmation

Complete Example Set

FileTypeAspect RatioPlacement
brand_video.mp4Main creative1:1 or 4:5Feed
brand_video_vertical.mp4Vertical variant9:16Stories/Reels
brand_video_horizontal.mp4Horizontal variant16:9In-stream/Desktop

Custom Aspect Ratio Suffixes

For teams with different naming conventions, you can configure custom aspect ratio suffixes in User Defaults.

Supported Custom Suffixes

SuffixParsed RatioExample
1x11.0 (square)product_1x1.jpg
4x50.8 (portrait)product_4x5.jpg
9x160.5625 (vertical)product_9x16.mp4
16x91.78 (horizontal)product_16x9.mp4
9160.5625 (vertical)product_916.mp4
450.8 (portrait)product_45.jpg

How Auto-Detection Works

When using custom suffixes, Ads Uploader automatically determines which file is the primary (feed) asset and which are variants:

  1. Primary Selection: The file with an aspect ratio closest to 1.0 (square) becomes the primary/feed asset
  2. Vertical Variants: Files with lower ratios than the primary become vertical variants (Stories/Reels)
  3. Horizontal Variants: Files with higher ratios than the primary become horizontal variants

Example:

  • Upload product_4x5.jpg (ratio 0.8) + product_9x16.jpg (ratio 0.5625)
  • Result: 4x5 becomes primary (closer to 1.0), 9x16 becomes vertical variant

Custom Delimiter

You can also change the delimiter between the base name and suffix. Default is underscore (_), but you can use hyphen (-) or other characters.

DelimiterExample
_ (default)product_9x16.mp4
-product-9x16.mp4

Configure these settings in Account > Defaults > Media Variants.