Creative Library
The creative library tracks every image and video you have uploaded to your Meta ad account. Each creative gets a metadata record with 30 fields covering dimensions, file size, aspect ratio, grouping, tags and upload status.
What Gets Tracked
When you upload a creative (through the web dashboard or through the AI copilot’s Google Drive integration), Adsap creates a metadata record with:
| Field | Description |
|---|---|
| Type | IMAGE or VIDEO. |
| Filename | The original filename. |
| Dimensions | Width and height in pixels (e.g., “1080x1080”). |
| File size | Size in megabytes. |
| Aspect ratio | The exact ratio (e.g., “1:1”, “9:16”, “16:9”). |
| Aspect ratio category | A category Adsap calculates for placement matching (see below). |
| Thumbnail | A preview thumbnail URL and storage path. |
| Content hash | A hash of the file content, for deduplication. |
| Thumbnail hash | A hash of the thumbnail, also for dedup matching. |
| Meta creative ID | The ID Meta assigns after upload. |
| Meta image hash / video ID | Meta’s internal reference for the asset. |
| Tags | Labels you define for organizing assets. |
| Video status | For videos only: tracks encoding progress. |
| Upload timestamp | When you uploaded the asset. |
Aspect Ratio Categories
Adsap calculates an aspect ratio category for every uploaded asset. The category decides which placement slots the asset fits:
| Category | Typical Ratios | Used For |
|---|---|---|
| Feed | 1:1, 4:5 | Feed placements, carousel cards. |
| Vertical | 9:16 | Stories, Reels, and other vertical placements. |
| Horizontal | 16:9 | In-stream video, search results, and other landscape placements. |
A database trigger sets the category whenever you upload a creative or its dimensions change. You never set it by hand.
Ad sheets have separate columns for square_creative, vertical_creative, and horizontal_creative. When you build an ad, assign a different asset to each slot so Meta serves the best-fitting creative for each placement.
Creative Groups and Auto-Pairing
Adsap organizes creatives into groups so carousel and multi-asset ads are quicker to build.
Group Types
| Group Type | Description |
|---|---|
| single | A standalone creative not part of any group (the default). |
| pair | Two creatives grouped together (e.g., square + vertical versions of the same visual). |
| triple | Three creatives grouped together (square + vertical + horizontal). |
Auto-Pairing
When you upload a new creative, Adsap’s auto-pair trigger checks whether an existing creative could be its partner. It looks at:
- The same ad account.
- Compatible aspect ratio categories (a square asset paired with a vertical asset, for example).
- Similar content (based on filenames or content hashes).
If it finds a match, it adds the new creative to the same group. Upload a 1:1 and a 9:16 version of the same visual and Adsap recognizes them as a pair.
You can also manage groups yourself in the dashboard by dragging creatives into or out of them.
Tip: Grouped assets make carousel cards quicker to fill. Each card can pull from a group and get the right aspect ratio for each placement.
Tags
Tags are labels you define, stored as JSON metadata on each creative. Organize your library any way that suits your workflow:
- By campaign: “summer-sale”, “holiday-2026”
- By product: “sneakers”, “dresses”, “accessories”
- By content type: “lifestyle”, “product-shot”, “ugc”
- By status: “approved”, “needs-review”
Tags are metadata only. Adsap does not send them to Meta, and they do not affect delivery. They exist for your own organization inside Adsap.
Video Status Tracking
Meta encodes every uploaded video. The video_status field tracks that progress:
| Status | Meaning |
|---|---|
| encoding | Meta has received the file and is encoding it. |
| processing | Meta is still processing the video. |
| ready | The video is fully encoded and ready to use in ads. |
| error | Encoding failed. Check the error details and try re-uploading. |
Important: Do not reference a video in an ad sheet row until its status shows ready. A video that is still encoding causes a launch error.
Check video status at any time:
- In the dashboard, the creative library shows status badges on video thumbnails.
- Via the AI copilot: “What is the status of my recent video uploads?”
Deduplication
Adsap uses content hashes and thumbnail hashes to detect duplicate uploads. Upload the same file twice and Adsap recognizes the duplicate from its content hash and can flag it, so your library does not fill with copies.
Browsing the Library
In the Web Dashboard
The creative library page shows your uploaded assets as a grid or a list. You can:
- Filter by type (image or video), aspect ratio category, tags, or upload date.
- Search by filename.
- View thumbnails and metadata details.
- Manage groups by dragging and dropping.
Via the AI Copilot
Show me all creatives in my ad account.List my video creatives and their encoding status.Which creatives are tagged "summer-sale"?Next Steps
To upload new creatives from Google Drive, see Google Drive Upload.