Documentation

Media Uploads

Uploader Panel Overview

The Uploader panel is the central hub for creating and configuring your Meta ads. It provides a streamlined workflow for uploading media and setting up ad campaigns.

Account Selection

Located at the top of the panel, the account selector allows you to:

  • Choose which ad account to work with
  • Search accounts by name or ID
  • Use keyboard navigation (↑↓ arrows + Enter)
  • Switch between accounts without losing your work

Media Upload Area

The drag-and-drop interface supports:

Supported Formats

  • Images: JPG, PNG, WebP, GIF (up to 30MB)
  • Videos: MP4, MOV (up to 4GB)

Upload Methods

  • Drag & Drop: Simply drag files from your computer
  • Click to Browse: Click the upload area to open file browser
  • Batch Upload: Select multiple files at once

Smart File Detection

Ads Uploader uses intelligent file naming to automatically organize your media. The system detects:

  • Thumbnail associations
  • Aspect ratio variations
  • Variation groupings for A/B testing

See detailed guides:

Configuration Methods

Choose how to configure your ad structure:

XLSX File Method

  • Upload an exported configuration from Meta Ads Manager
  • Perfect for replicating existing ad structures
  • Can be saved as presets for reuse

API Selection Method

  • Browse and select existing ads directly
  • Real-time connection to your Meta account
  • Full control over creative enhancements

Campaign & Ad Set Options

Customize your campaign structure:

  • Create new campaigns or use existing ones
  • Generate ad sets per upload or group variations
  • Use dynamic naming patterns with {FileName} placeholder

Ad Text Configuration

Two approaches for ad copy:

  • Common Text: Apply the same text to all ads
  • Individual Text: Customize each text per ad

Upload Process

  1. Select Account - Choose your working ad account
  2. Upload Media - Drag and drop your files
  3. Choose Configuration - XLSX or API method
  4. Set Options - Campaign, ad set, and naming preferences
  5. Configure Text - Add texts, set-up destination links and CTAs
  6. Export/Create - Generate XLSX or create ads directly