> ## 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.

# Leaderboard, themes and notes

> Track which creatives are rising and falling week over week, see every messaging theme you run with its hit rate, and keep your team's learnings in one feed.

Three pages in the Ad Library sidebar turn your creative data into a weekly routine: the **Leaderboard** for what moved, **Messaging themes** for which ideas work, and **Notes** for what the team learned.

***

## Leaderboard

The Leaderboard tracks performance shifts and top creatives: the **last 7 days against the 7 days before**.

**Performance shifts** at the top sorts your creatives into lifecycle segments — **Scaling**, **Declining**, **Newly launched** and **Recently paused** — with their spend and ROAS and how each changed since last week.

![The Leaderboard page with Performance shifts on the Scaling tab](https://mintcdn.com/theoptimizer/6J-BODW1xSX2h1dG/images/ad-library-leaderboard.png?fit=max\&auto=format\&n=6J-BODW1xSX2h1dG\&q=85\&s=4634e8013e502c67c719bb4021f703bc)

The **Creative leaderboard** below ranks creatives in two views:

| View | What it ranks |
| - | - |
| **Top** | Your best creatives on your [goal metric](https://docs.theoptimizer.io/ad-library/tags-and-settings.md#goal). |
| **Worst** | Creatives that earned back less than they spent (ROAS below 1), biggest spend first. |

Each row shows the creative's rank and how it moved since last week, its **share of spend**, its **weeks on board**, **spend** and **ROAS**. Click a row to open the creative.

![The Creative leaderboard with rank and movement, share of spend, weeks on board, spend and ROAS](https://mintcdn.com/theoptimizer/6J-BODW1xSX2h1dG/images/ad-library-creative-leaderboard.png?fit=max\&auto=format\&n=6J-BODW1xSX2h1dG\&q=85\&s=8fe089e512e54152ebbf36fee7d68f65)

***

## Messaging themes

**Messaging themes** lists every messaging angle you run, with its definition, spend and hit rate over the last 30 days.

* **Hit rate** is the share of a theme's delivering ads that cleared your winner bar (ROAS of 1 or more on your goal ROAS).
* Each theme is marked **Proven** or **Testing** by how reliably it produces winners. A theme with fewer than 5 delivering ads isn't rated yet.
* Sort the list by **Proven**, **Spend**, **Active** or **Hit rate**. Themes that didn't run in the window are listed separately as **Not running**.

Click a theme to see its top creatives, how it has run over the last twelve months, and **What's pairing well** — the hooks, personas and other tags that win most often alongside it.

![Messaging themes, each with its definition, spend, active ads, hit rate and share of spend](https://mintcdn.com/theoptimizer/6J-BODW1xSX2h1dG/images/ad-library-themes.png?fit=max\&auto=format\&n=6J-BODW1xSX2h1dG\&q=85\&s=8876d09cb12b5d7fa76b2f770e3e6658)

> [!TIP]
>
> Themes come from the AI's **angle** tag. If the page is empty, turn on [auto-tagging](https://docs.theoptimizer.io/ad-library/tags-and-settings.md#auto-tagging) so your creatives get analysed.

***

## Notes

**Notes** collects what your team learned from its ads, newest first. You write a note from any creative's **Notes** tab in the [creative inspector](https://docs.theoptimizer.io/ad-library/creative-inspector.md#notes); it shows up here with the creative it's about.

Filter the feed by **All**, **Active** or **Archived**. Archive a note when it's no longer relevant; archived notes stay greyed out until you restore them.


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