Skip to main content

Documentation Index

Fetch the complete documentation index at: https://theoptimizer.io/docs/llms.txt

Use this file to discover all available pages before exploring further.

The Creative Library is a centralized collection of all your ads, images, videos, and text copies pulled from every connected ad network and ad account. Instead of browsing creatives one campaign at a time inside Facebook, TikTok, or another ad manager, it brings everything together in one place and shows you how each creative performs across all the campaigns where it has been used. Your creative team can also upload and tag new assets here so media buyers can pull them directly into the Campaign Creator — no file sharing, no copy-pasting URLs.

​
Why use the Creative Library

​
Cross-campaign creative analysis

Native ad managers show you how an ad performs inside a single campaign. The Creative Library aggregates performance across every campaign, ad set, and ad account where a creative, image, video, or headline has been used — giving you a true picture of which assets are your winners. Sort by Spend, CTR, EPC, or usage count to instantly identify top performers and underperformers across your entire operation.

​
Creative storage and organisation

The Creative Library serves as a centralized storage hub for all your ad assets. Upload images, videos, and text copies, organize them with tags, and keep everything in one place. No more scattered files across local folders, shared drives, or chat threads. When it is time to launch a new campaign, your assets are already inside the platform, tagged and ready to use.

​
Bridge between creative team and media buyers

Most teams have a separation between the people who produce creatives and the people who launch campaigns. The Creative Library eliminates the handoff friction. The creative team uploads and tags assets; media buyers pull them by tag directly inside the Campaign Creator. No file sharing, no messages asking “where is that new batch?” — the workflow stays inside TheOptimizer.

​
Creative performance feedback loop

After campaigns run, the creative team can come back to the Creative Library to review how their assets performed using the aggregated metrics across all campaigns. This makes it easy to spot which creative directions are working and which ones should be retired or iterated on — without needing access to the campaign management side of the platform.

​
Safeguard against ad account loss

If you lose access to a Facebook ad account — whether due to a policy violation, a disabled Business Manager, or any other reason — all creatives from that account remain available in the Creative Library. TheOptimizer saves a local copy of every creative it pulls from your ad networks. Even if the original ad account is gone, your images, videos, and text copies stay accessible for reuse in new accounts and new campaigns.

​
What’s inside — Creatives, Media, and Headlines

Access the Creative Library from the left-hand navigation menu under Creative Library. Expanding it reveals three sub-sections:
This section shows full ads as they were pulled from your ad networks — the complete creative unit including image or video, headline text, primary text, and call to action.Each card in the grid displays:
  • A thumbnail preview of the ad
  • The ad network icon it belongs to
  • A badge showing how many campaigns it is used in
  • Three key performance metrics: Spend, CTR, and EPC

​
Aggregated performance metrics

This is the most powerful aspect of the Creative Library. Instead of showing performance for a single ad in a single campaign, every item in the library shows aggregated metrics across all campaigns where it has been used. For example, if the same image has been uploaded as an ad across five campaigns in three different ad accounts, the Media section shows the total Spend, CTR, EPC, Revenue, Clicks, and Impressions from all five campaigns combined. The same applies to Creatives (full ads) and Headlines (text copies). Each card in the grid shows three metrics at a glance: Spend, CTR, and EPC. For the full set — Revenue, Clicks, Impressions, and more — click on the item to open the Creative Details preview.
This cross-campaign view of creative performance is not available in any native ad manager, where performance is always scoped to a single campaign.
The top bar of each section provides filtering and sorting options to help you find what you are looking for quickly. Filtering options:
  • Metrics — filter by performance thresholds. For example: show only creatives where Spend is greater than $100, or CTR is above 2%. You can combine multiple metric conditions.
  • Tags — filter by tags assigned to creatives. Useful when your team has tagged assets by campaign, media buyer name, creative batch, or any other convention.
  • Traffic Source — filter by ad network to see only creatives from Facebook, TikTok, Taboola, or any other connected network.
  • Accounts — filter by specific ad accounts.
Sorting options:
  • Spend Highest / Spend Lowest — sort by total spend across all campaigns
  • Newest / Oldest — sort by creation date
  • CPR — sort by cost per result
  • Most Used / Least Used — sort by the number of campaigns where the creative, image, or headline has been used
Search — search by text content, image name, or video name. Date picker — adjust the date range for the performance metrics displayed. This controls the time window for all statistics shown on the cards. Show Uploaded Only — a toggle on the right side of the toolbar. When turned on, the view filters to show only assets your team has manually uploaded to the Creative Library, excluding creatives that were automatically pulled from your running campaigns.

​
Uploading new assets

Each section has its own upload button at the top: + Upload New Creatives, + Upload New Media, or + Upload New Headlines.

​
Uploading creatives

Click + Upload New Creatives in the Creatives section. The upload screen has two main areas:
  • Headlines — enter the headline text that will display with your media. Enter one headline per line. You can also click Use Headlines from Creative Library to pull in existing headlines already stored in the library.
  • Media — upload images or videos by dragging them into the drop zone or clicking to browse. You can also click Add Media from URL to import from a URL, or Use Media from Library to pull in images or videos already stored in the Media section.
Limits: max 100 images and 20 videos per upload; minimum dimensions 100×100px. The Creatives Preview panel on the right shows a live preview of the creative combinations that will be generated from the headlines and media you have added. Add tags at the bottom before clicking Upload New Creatives to submit.

​
Uploading media

Click + Upload New Media in the Media section. Drag images or videos into the drop zone or click to browse. You can also use Add Media from URL to import from external URLs. The same limits apply: max 100 images, 20 videos, minimum 100×100px. Add tags at the bottom before clicking Upload New Images and Videos to submit.

​
Uploading headlines

Click + Upload New Headlines in the Headlines section. Enter your text copies in the text area — one headline per line. The Headlines Preview panel on the right shows a preview of what will be uploaded. Add tags at the bottom before clicking Upload New Headlines to submit.

​
Uploading via API

For teams that want a fully automated pipeline, TheOptimizer supports uploading creatives, media, and headlines via API. This is useful when your creative team stores assets in a shared folder or DAM system — a technical team member can set up an automated process that pushes new files to the Creative Library automatically, with tags applied programmatically. Contact support or refer to the API documentation for details.

​
Tagging

Tags are the organizational backbone of the Creative Library. Every creative, image, video, and headline can be tagged with one or more labels that you define. How to add tags:
  • During upload — use the Tags field at the bottom of the upload screen before submitting
  • After upload — click on any item to open the Creative Details preview, then use + Add Tags
  • In bulk — select multiple items, then use the bulk action to add tags to all selected items at once
Common tagging conventions:
  • By media buyer name — so each team member can filter to find their own creatives
  • By creative batch or campaign — e.g., March-batch-1, summer-promo
  • By content type — e.g., UGC, product-shot, testimonial
  • By status — e.g., approved, testing, winner
Tags you add in the Creative Library are also available as filters inside the Campaign Creator when you are selecting media for a new campaign. This is what enables the team workflow described below — establishing a clear tagging convention is the single most important thing you can do to make the Creative Library effective.

​
Creative Details preview

Click on any item in the grid to open the Creative Details dialog. It provides:
  • Preview — a larger view of the creative, image, or headline
  • Tags — view and add tags directly from this dialog
  • Ad Network — which network this creative belongs to
  • Extended performance metrics — the full set of aggregated KPIs: Spend, CTR, EPC, Revenue, Clicks, and Impressions (the grid view only shows three)
  • List of Campaigns — every campaign where this creative is currently being used; each campaign name is clickable and takes you directly to that campaign in the Campaigns section
  • Clone Creative — duplicate the creative within the library
The campaign list is particularly useful for auditing — you can see at a glance where a creative is running and click through to check performance or make changes at the campaign level.

​
Bulk actions

Select multiple items in the grid by clicking their checkboxes or using Select All. Once you have a selection, the following bulk actions are available:
  • Delete — remove the selected items from the library
  • Clone — duplicate the selected items
  • Add Tags — apply one or more tags to all selected items at once
Bulk tagging is especially useful when you receive a batch of new creatives and want to tag them all with the same label before your media buying team starts using them.

​
Grid view vs. table view

The Creative Library supports two display modes, toggled from the icons in the top-right corner of each section:
  • Grid view (default) — shows creatives as visual cards with thumbnails and three key metrics (Spend, CTR, EPC). Best for browsing visually and quickly recognizing images or videos.
  • Table view — shows creatives in a row-based table with all performance columns visible. Best for comparing metrics side by side, sorting by specific columns, and working with large numbers of items where scanning a table is faster than scrolling a grid.

​
Integration with the Campaign Creator

The Creative Library integrates directly into the Campaign Creator to streamline campaign creation. When you reach the media upload step in the Campaign Creator, you have the option to browse and pull assets from the Creative Library instead of uploading from your computer. You can filter by tags, sort by performance, and select the creatives you want to use — all without leaving the Campaign Creator. This means your team does not need to re-download images from one place and re-upload them somewhere else. Assets already in the Creative Library are immediately available for any new campaign. The same applies to headlines — when writing ad copy in the Campaign Creator, you can pull in text copies from the Creative Library’s Headlines section.
For the best workflow, upload and tag your creatives in the Creative Library first, then open the Campaign Creator and filter by tag. This is faster than uploading from your computer every time — especially when different team members are responsible for creative production and campaign launching.

​
Team workflow — creative team and media buyers

The Creative Library is designed to support a clear separation of responsibilities between creative production and campaign management.
1

Creative team uploads and tags

The creative team uploads images, videos, and text copies to the Creative Library and tags them using the convention your team has agreed on — by media buyer name, campaign type, batch date, or any other system. This can be done manually through the interface or automatically via API.
2

Media buyers pull creatives by tag

When a media buyer opens the Campaign Creator to build a new campaign, they browse the Creative Library from within the launcher. They filter by tag, select the assets they need, and use them in the campaign — without coordinating directly with the creative team for file handoffs.
3

Creative team reviews performance

After campaigns have been running, the creative team returns to the Creative Library to check how their assets are performing using the aggregated metrics across all campaigns. This helps them identify winning creatives worth iterating on and underperformers that should be retired or reworked.
4

Repeat the cycle

This cycle repeats regularly for most teams: produce → upload and tag → launch → review → iterate.
Establishing a clear tagging convention across your team is the single most important thing you can do to make the Creative Library effective. Without consistent tags, media buyers spend time searching instead of launching.