Documentation

Accounts & Billing

User Defaults

Customize Ads Uploader settings to match your team's workflow and naming conventions.

Access your defaults at Account > Defaults.

General Settings

Configure upload and ad configuration options.

Turbo Mode

Toggle the faster upload system with improved speeds and reliability.

  • On (default): Faster uploads with improved reliability
  • Off: Direct uploads to Facebook servers

Show Profile Options

When enabled, Facebook Page and Instagram Account selectors appear in the ad configuration panel. This is useful if you manage multiple pages or Instagram accounts and need to select which profile the ad posts from.

  • On: Page/Instagram selectors visible in ad configuration
  • Off (default): Uses the page/account from your base ad

Show URL Parameters

Controls whether the URL parameters (UTM tags) field is visible and editable in the ad configuration panel.

  • On: URL parameters field visible for editing
  • Off (default): URL parameters inherited from base ad

Media Variants

Configure how Ads Uploader detects and groups aspect ratio variations of your creatives.

Enhanced Variant Detection

Controls which naming patterns are recognized for grouping media variants.

Enhanced Mode (default):

  • Recognizes aspect ratio suffixes: _1x1, _4x5, _9x16, _16x9
  • Also recognizes word suffixes: _vertical, _horizontal
  • Works with or without a "base" file (no suffix)
  • Automatically determines which file is primary based on aspect ratio

Legacy Mode:

  • Only recognizes _vertical and _horizontal suffixes
  • Requires a base file without any suffix

How Enhanced Mode Works

When you upload files with aspect ratio suffixes, the system:

  1. Parses each suffix to calculate the aspect ratio (e.g., 4x5 = 0.8, 9x16 = 0.5625)
  2. Selects the file closest to 1.0 (square) as the primary/feed asset
  3. Files with lower ratios become vertical variants (Stories/Reels)
  4. Files with higher ratios become horizontal variants

Examples:

Files UploadedPrimary (Feed)VerticalHorizontal
ad_1x1 + ad_9x16_1x1_9x16-
ad_4x5 + ad_9x16_4x5_9x16-
ad_4x5 + ad_16x9_4x5-_16x9
ad_4x5 + ad_9x16 + ad_16x9_4x5_9x16_16x9

Separator

The character(s) between the base filename and the suffix. Default is underscore (_).

SeparatorExample
_ (default)creative_9x16.mp4
-creative-9x16.mp4

Thumbnail Matching

Configure how thumbnail images are matched to videos.

SettingDefaultDescription
Separator_Character between filename and suffix
SuffixthumbnailWord that identifies thumbnail files

Examples:

SeparatorSuffixVideoThumbnail
_thumbnailpromo.mp4promo_thumbnail.jpg
-thumbpromo.mp4promo-thumb.jpg
_coverpromo.mp4promo_cover.jpg

Separate Ads Naming

When using the "Separate Ads" text strategy (creating individual ads for each headline/body combination), configure how the ad variations are named.

Settings

SettingDefaultDescription
Separator_Character(s) between ad name and suffix (max 3)
Headline PrefixHPrefix for headline variations (max 10)
Primary Text PrefixPPrefix for primary text variations (max 10)

Preview

With default settings, ads are named like:

  • Headline variation only: AdName_H1, AdName_H2
  • Primary text variation only: AdName_P1, AdName_P2
  • Combined: AdName_H1_P1, AdName_H1_P2, AdName_H2_P1, etc.

Custom Example

With separator -, headline prefix hl, and primary text prefix pt:

  • AdName-hl1-pt1, AdName-hl1-pt2, AdName-hl2-pt1, etc.

This naming pattern is used in both Excel/CSV exports and API-based ad creation.