> ## Documentation Index
> Fetch the complete documentation index at: https://docs.theoptimizer.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Tags and settings

> Set up how the Ad Library describes and ranks your creatives: AI tags, custom tags, naming rules that turn your ad names into labels, AI auto-tagging, the goal metric and shared report links.

Tags are what let you compare creatives by idea instead of one ad at a time — every hook against every other hook, one persona against another. The Ad Library has three kinds of tags, and you can filter and group any report by all of them.

Open **Settings** with the gear icon at the top of the Ad Library sidebar. It has six tabs:

| Tab | What it's for |
| - | - |
| **AI tags** | What each AI tag means and how your ads are grouped by it. |
| **Custom tags** | Your own tags, beside the AI ones, for grouping ads your way. |
| **Naming convention** | Rules that read tags from the way your campaigns and ads are named. |
| **Auto-tagging** | Let AI tag new creatives on its own, within a monthly credit limit. |
| **Goal** | The metric your Ad Library ranks creatives by. |
| **Shared links** | Every public report link your workspace has made, in one place. |

![Ad Library Settings on the AI tags tab, with the Asset type tag and its values](https://mintcdn.com/theoptimizer/6J-BODW1xSX2h1dG/images/ad-library-settings.png?fit=max\&auto=format\&n=6J-BODW1xSX2h1dG\&q=85\&s=906d2dceaa35a8ab82c5d5cde60c6ba0)

***

## AI tags

AI tags are set by AI from the creative itself: it watches or reads each creative and tags what's in it. The **AI tags** tab lists them in groups — **Visual** (asset type), **Persona** (intended audience), **Messaging** (messaging theme, offer type, emotion, CTA type) and **Hook** (hook tactic) — each with what it means, its values and how many creatives have each value. Use **Add value** to add a value the AI can pick.

Tags listed under **Set by creative analysis** come from the [AI analysis](https://docs.theoptimizer.io/ad-library/creative-inspector.md#ai-analysis) and can't be edited here. You can also correct a tag on a single creative from the [creative inspector](https://docs.theoptimizer.io/ad-library/creative-inspector.md#tags-on-a-creative).

Creatives get AI tags when they're analysed — automatically with [auto-tagging](#auto-tagging), or one at a time with **Analyse** in the inspector.

***

## Custom tags

Custom tags label creatives your own way — by creator, product, funnel stage, or anything else your team tracks. You tag creatives by hand, and can filter and group reports by them.

**1. Create the tag**

On the **Custom tags** tab, click **New custom tag** and give it a name, for example *Funnel stage*.

**2. Choose how many values a creative can have**

**One value** (one per creative, like a funnel stage) or **Several values** (like the products an ad shows).

**3. Add the first values**

Optionally type the first values, pressing **Enter** or a comma after each one, or paste a list. Then click **Create tag**.

Tag a creative from the **Custom tags** card in its inspector. Rename a tag or add a description with **Edit tag**; renaming keeps every creative's values and the reports that use it. Archived values are hidden from the pickers, but creatives already tagged keep them.

***

## Naming convention

If you already put information in your campaign, ad set or ad names — a creator, an offer, a date, a test ID — a naming rule turns those parts into labels you can filter, group and compare by. Nothing in your ad accounts changes.

**1. Start a rule**

On the **Naming convention** tab, click **New naming rule** (or **Set up a naming rule**). Pick the **platform** and the **name level** to read: campaign, ad set or ad names.

**2. Split an example name into parts**

The rule shows one of your most-used names, split by its separator. Use **AI detect** to propose a whole rule from your names, or set the **Separator** and structure yourself.

**3. Name the parts that matter**

Give each useful part a name to turn its values into a label — or set it to **Ignore**. For a part with a fixed list of values, map each spelling in your names to the value it should show as, for example *us* → *United States*.

**4. Save and review**

Click **Save rule**. Every name is checked against the rule, and names that don't fit appear under **Needs review**, where you can merge a misspelling into an existing value, add it as a new value, or map it.

> [!TIP]
>
> The **Values** tab of a rule shows every value it has read, with how many ads use it, and asks you to decide when a new value appears that looks like one you already have.

***

## Auto-tagging

Auto-tagging lets AI tag new creatives on its own as they arrive, so your reports and themes always have tags to group by.

| Setting | Options |
| - | - |
| **New creatives** | **Off**, **Images only** (low cost per creative), or **Images and videos** (every new creative; a video costs several times more than an image). |
| **Monthly credit limit** | The most auto-tagging can spend in a month. The default is a quarter of your workspace's AI credits. When the month's limit is reached, auto-tagging pauses and resumes on the 1st. |
| **Existing creatives** | Turn on **Also tag creatives you already have** to tag the ones that delivered in the last 30 days too, highest spend first, until the monthly limit. |

The tab shows how many credits auto-tagging has used this month, and how much of your workspace's AI credits are used overall.

![The Auto-tagging settings: new creatives Off, Images only or Images and videos, the monthly credit limit, and the option to tag existing creatives](https://mintcdn.com/theoptimizer/6J-BODW1xSX2h1dG/images/ad-library-auto-tagging.png?fit=max\&auto=format\&n=6J-BODW1xSX2h1dG\&q=85\&s=5572e55ffd3a247373d60507528e9dfd)

> [!NOTE]
>
> Only a workspace admin can change the auto-tagging and goal settings.

***

## Goal

The goal is the metric that decides your top creatives and winners across the Ad Library — on Home, the leaderboard, themes and launch reports.

* **ROAS (ad platform)** — revenue the ad platform reports, over spend.
* **ROAS (tracker)** — revenue your tracker reports, over spend. Use it when the platform doesn't get all your revenue.

Both ROAS columns stay available in your reports either way.

***

## Shared links

The **Shared links** tab lists every public link created for an Ad Library report in your workspace, with who it's for and when it expires. Turn off a link here and it stops working for everyone who has it. See [Sharing a report](https://docs.theoptimizer.io/ad-library/reports.md#sharing-a-report).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.