> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.laposta.org/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.laposta.org/_mcp/server.

# Using labels on subscribers

> Give your subscribers custom labels to filter by, send campaigns to a selection, and use in segments and automations.

A label is a tag you come up with yourself and attach to a subscriber, such as ‘Customer’, ‘Quote’ or ‘Trade fair’. A single subscriber can have multiple labels, and each list has its own labels.

You can use them to filter in the subscriber overview, choose the recipients for a campaign, set a condition in a segment, and as a starting point or action in an automation.

## Managing labels

Go to Subscribers, click on your list, and click on ‘Labels’ at the top. You will see all the labels for that list along with the number of active subscribers per label.

![The Labels screen with an input field for a new label and a table showing three labels, the colour strip and the number of active subscribers](/_fern-files/_img/7e1a098aaaa7625b518b30b2fc857da1918f2d932868247e8668252a44bd1ebb.webp)

On this screen, you can manage the labels for the list:

* Create: type a name into the field and click on ‘Add’. You do not have to create labels in advance, by the way. They are also created automatically as soon as you enter a new name for a subscriber or include it during an import.
* Assign a colour: hover your mouse over a label and click on a colour in the strip that appears. The label will be shown in this colour everywhere it appears.
* Change name: double-click on the label or click on the pencil icon next to it, edit the name, and click on ‘Save’. Segments and campaigns that use the label will continue to work as normal.
* Merge: if you give a label the same name as an existing label, Laposta will suggest merging them. Once you confirm, all subscribers will receive the existing label, and segments and campaigns will be updated automatically. However, you will still need to manually update any automations that use the old label. The confirmation screen will show you which ones are affected.
* Delete: click on the rubbish bin icon. If the label is still being used somewhere, Laposta will warn you first and show you exactly where.

> **Warning**
>
> If you delete a label and then create a new one with the exact same name, the old label will be restored, including the subscribers and segments that used it. If you want to start completely fresh, choose a different name.

## Adding labels to subscribers

#### A single subscriber

Open the subscriber's details and select or type a label in the ‘Labels’ field. If you type a name that does not exist yet, you will immediately create a new label.

#### Multiple subscribers at once

Go to Subscribers → Browse, tick the subscribers, and click on ‘Change labels’. In the window, select or type one or more labels and indicate whether you want to add them to or remove them from the selection.

#### During an import

During [the import](/hoe-importeer-ik-een-groot-relatiebestand), link a column from your file to ‘Labels’. If that column is called `labels` or `tags`, the link will already be set up for you. Separate multiple labels in a single cell with a comma or a vertical bar. Values that do not exist yet will become new labels.

#### Automatically

An automation can add and remove labels using [the Labels action](/automation-bouwstuk-labels). This is useful if you want to give someone a label after a specific action, such as everyone who clicked on a link.

## Filtering and exporting

Under Subscribers → Browse, the labels are displayed next to each subscriber. Click on a label to view only the subscribers with that label, or select a label from the list in the top right corner.

If you then export your list, Laposta will apply the active filter and you will only get the filtered subscribers. The export file contains a ‘Labels’ column with the labels for each subscriber.

## Sending a campaign to subscribers with a label

When creating a campaign, you tick a list in step 2 (‘Select recipients’). If that list has labels, you can select one or more labels instead.

![The Select recipients step showing an expanded labels block below the list name, with two labels selected and the number of recipients displayed](/_fern-files/_img/8ef767775cbd401f5e63b533f718614b4d2609eb07c78f35bb8ff48bbdaac98b.webp)

The campaign will then be sent to everyone with at least one of the selected labels. The number of recipients is shown immediately. If you also select segments or other lists, Laposta automatically removes duplicates so that nobody receives the campaign twice.

## Using labels in a segment

If you want to combine a label with another condition, such as the label ‘Customer’ as well as the city London, create a [segment](/hoe-segmenteer-ik-op-basis-van-relatiegegevens). Select the ‘Labels’ field as the condition and choose one or more labels.

## Using labels in an automation

With the [Add label](/startmoment-label-toevoegen) starting point, an automation starts as soon as a subscriber receives a label. With [the Labels action](/automation-bouwstuk-labels), you can add or remove a label partway through the automation. In addition, you can use labels just like any other field in the [If/then](/als-dan) and [Wait until…](/wacht-tot) actions.

## Retrieving and assigning labels via the API

You can also retrieve and assign labels via [the API](/api). As soon as a list has at least one label, they appear for the subscriber as a field named `labels`. When you request the fields of a list, all labels for that list are included as the possible values for that field.

When adding or updating a subscriber, you pass labels as an array:

**`Twee labels aan een relatie hangen`**

```bash title="Twee labels aan een relatie hangen"
curl https://api.laposta.nl/v2/member/name@example.com \
  -u YOUR_API_KEY: \
  -d list_id=YOUR_LIST_ID \
  -d "custom_fields[labels][]=Customer" \
  -d "custom_fields[labels][]=Trade fair"
```

The square brackets are required. If you leave them out, the label will not be saved, even though the API does not return an error message.

> **Warning**
>
> Via the API, you can only pass labels that already exist. If you pass a name that the list does not have, you will receive error code 203 with the message that the option is unknown. Therefore, always create new labels in your account or via an import first.

## Related articles

#### [What are active, unsubscribed and cleaned subscribers?](/waar-vind-ik-een-overzicht-van-actieve-uitgeschreven-en-opgeschoonde-relaties)

On the Subscribers → Browse page, you can see per tab who receives your newsletters…

#### [Creating a segment based on subscriber data](/hoe-segmenteer-ik-op-basis-van-relatiegegevens)

Divide your list using selection rules based on your subscribers' data.

#### [Adding or removing labels in an automation](/automation-bouwstuk-labels)

Automatically assign one or more labels to a subscriber during an automation, or remove…

#### [Importing a file with subscribers from Excel or CSV](/hoe-importeer-ik-een-groot-relatiebestand)

Add new subscribers to your list all at once or update the data of your existing…