> For the complete documentation index, see [llms.txt](https://docs.adalysis.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adalysis.com/meta-facebook/managing-meta-accounts/labels.md).

# Labels

Put your own labels on campaigns, ad sets, and ads, then filter by them and use them in rules

Labels are names you put on campaigns, ad sets and ads, such as "Brand", "Prospecting", or "UGC". Use them to group things that belong together whatever their names, to filter the grids, and to tell rules what to act on.

{% hint style="info" %}
These are **Adalysis labels**. They are kept in Adalysis and never written to Meta, so they don't show in Ads Manager. They are not Ads Manager's campaign tags: Meta doesn't share those with other tools, so Adalysis can't show them either.
{% endhint %}

## Where labels show

| Screen                                                                                                                               | Labels on                   | What you can do                                                                                    |
| ------------------------------------------------------------------------------------------------------------------------------------ | --------------------------- | -------------------------------------------------------------------------------------------------- |
| [Budgets > **Manage**](https://docs.adalysis.com/meta-facebook/budgets/manage-budgets.md#labels)                                     | Campaigns and ad sets       | **Labels** column with a pencil, **Labels** filter                                                 |
| [Performance > **Overview**](https://docs.adalysis.com/meta-facebook/performance/performance-overview.md#labels), **Campaigns** grid | Campaigns and ad sets       | **Labels** column with a pencil, **Labels** filter                                                 |
| [Performance > **Ads**](https://docs.adalysis.com/meta-facebook/performance/ads/the-ads-screen.md#labels)                            | Ads                         | **Labels** column with a pencil, **Labels** filter, and the **Labels** button for the ads you tick |
| [Performance > **Rules**](https://docs.adalysis.com/meta-facebook/managing-meta-accounts/rules.md#label-rules)                       | Campaigns, ad sets, and ads | **Label** filter, and the **Add label** and **Remove label** actions                               |

Good to know:

* Every label belongs to one ad account. Each ad account has its own list of labels.
* A label is only on the row you put it on. An ad set doesn't take its campaign's labels, and an ad doesn't take its ad set's. The Ads screen shows each ad's own labels.
* The CSV downloads of the three grids have a **Labels** column, with the names separated by commas.
* Anyone with edit access to the ad account in Adalysis can change labels. A Meta login that can only view the account is enough, because nothing is sent to Meta.
* Team members with view-only access see the labels, but get no pencil and no **Labels** button.

## Add or remove labels

The **Labels** column shows each row's labels as colored chips. To change them:

![Labels pop-up of a campaign](https://3203600314-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGlXujWJyreRidNjZDCw2%2Fuploads%2FAKGvS5KbORpmayrAl9rW%2FLB-01.png?alt=media)

* ① Click the pencil in the row's **Labels** cell. The pop-up lists the ad account's labels, with a tick on those the row has.
* ② Click a label to tick or untick it.
* ③ To find a label, type part of its name in **Find or create a label**. To create one, type a new name, then click **+ Create “name”** under the list, or press Enter. The new label is added to the list, ticked.
* ④ Click **Save**.

⑤ The note is a reminder that these are Adalysis labels. ⑥ **Manage labels** opens [Manage labels](#manage-labels).

You can also type a name and click **Save** straight away. A new name creates the label and puts it on the row. The name of a label you already have ticks that label.

* A name can be up to 100 characters.
* Two labels in one ad account can't have the same name, even in a different case: "Brand" and "brand" are the same label.
* A new label takes the next color in turn. You can change it in [Manage labels](#manage-labels).

### Label many ads at once

On the Ads screen you can change the labels of several ads in one go:

![Labels of the ticked ads](https://3203600314-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGlXujWJyreRidNjZDCw2%2Fuploads%2FW0pz7MuDstpka4T8v6iK%2FLB-02.png?alt=media)

* ① Tick the ads.
* ② Click **Labels** in the toolbar. It is grayed out until you tick an ad.

3. In the pop-up, ④ a tick means every ticked ad has the label, and ⑤ a dash means only some do.
4. Click a label to change it:
   * an unticked label goes on every ticked ad;
   * a ticked label comes off every ticked ad;
   * a dash becomes a tick, which puts the label on every ticked ad. Click again to take it off them all, and once more to leave it as it was.

* ③ Click **Save**.

Only what you changed is saved. A label you left with a dash stays on the ads that had it. One change can cover up to 1,000 ads.

## Manage labels

**Manage labels** is where you create, rename, recolor, and delete the ad account's labels. Open it from:

* the **Manage labels** link in the pencil's pop-up (which closes that pop-up), or
* the **Manage labels** link in a **Labels** filter row.

![Manage labels pop-up](https://3203600314-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGlXujWJyreRidNjZDCw2%2Fuploads%2FxJlrgbJsiOPu4et02LvY%2FLB-03.png?alt=media)

* ① **Create a label**: type it in **New label name**, then click **Create label** (or press Enter). It isn't on anything yet.
* **Change the color**: click the label's ② color swatch, then click one of the 12 colors in ③ the palette. **Cancel** closes the palette.
* ④ **Counts**: each label shows how many campaigns, ad sets and ads have it, for example "2 campaigns, 1 ad set, 30 ads", or **Not used**.
* ⑤ **Rename**: change the name, then click **Save** (or press Enter). Changing only the case is allowed.
* ⑥ **Delete**: Adalysis asks first and says what the label is on, for example "Delete “Brand”? It is on 12 campaigns and ad sets." Click **Delete** to confirm.

Changes show in the grids straight away.

{% hint style="warning" %}
Deleting a label takes it off every campaign, ad set and ad, and can't be undone. Rules that name it are not changed: a **Label** filter or a **Remove label** rule then finds nothing, and an **Add label** rule creates the label again the next time it adds it.
{% endhint %}

## Filter by label

Each of the three grids has a **Labels** filter.

![Labels filter row](https://3203600314-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGlXujWJyreRidNjZDCw2%2Fuploads%2FaVNravJsHSFi6cfvPqKH%2FLB-04.png?alt=media)

* ① Click **Filters**, and choose **Labels** in a row's first box (or add a row with **+ Add another**).
* ② Choose **has any of**, **has all of** or **has none of**.
* ③ Tick one or more labels in the box.

4. Click **Apply**.

④ **Manage labels** opens [Manage labels](#manage-labels).

| Choice          | Shows the rows that have            |
| --------------- | ----------------------------------- |
| **has any of**  | at least one of the ticked labels   |
| **has all of**  | every ticked label, on the same row |
| **has none of** | none of the ticked labels           |

A row with no label ticked doesn't filter anything.

On **Manage budgets** and the **Overview** campaigns grid, labels work like the ad set name conditions:

* A campaign is shown when it has the labels itself, or when one of its ad sets does.
* Opened, a campaign that has the labels itself shows all its ad sets. Otherwise it shows only the ad sets that have them.
* With **has all of**, every label must be on the same row. A campaign labeled "A" with an ad set labeled "B" doesn't match **has all of** "A" and "B".
* With **has none of**, a campaign that has one of the labels is left out with all its ad sets, and so is any ad set that has one.

On the **Ads** screen, the filter looks at each ad's own labels only.

## Labels in rules

Rules can find what to act on by label, and can add or remove a label themselves:

* **Label** **has** or **doesn't have** a label, as a filter under **Applies to**.
* **Add label** and **Remove label**, as the rule's action, on campaigns, ad sets, or ads.

So a rule can, for example, label every ad set whose cost per conversion is too high, or every campaign whose name contains "brand". See [Rules](https://docs.adalysis.com/meta-facebook/managing-meta-accounts/rules.md#label-rules).

## When a campaign, ad set or ad is removed

* When Meta stops listing a campaign or ad set, Adalysis keeps its labels for one more night, in case it comes back. If it is still gone the night after, its labels are removed.
* Ads keep their labels. A removed ad drops out of the Ads screen's default view, which shows ads that are **On**.

## Change history

[Change history](https://docs.adalysis.com/meta-facebook/managing-meta-accounts/change-history.md) lists every label created, renamed, recolored, or deleted, and every label added to or removed from a campaign, ad set or ad, with who did it. A change made by a rule names the rule.
