Atlas L6ynztjd84

Stay updated on the status of all your company's support tickets.

Customer portal

Organise contacts and offer a subscriber preference center with mailing lists.

Lists are the preferred way of managing your contacts in Loops.

In addition to providing fine-grained control over your audience, using Lists will automatically generate a branded Preference Center for contacts in your audience, allowing them to easily manage their subscription preferences.

Lists can be public or private and contacts can belong to many, one, or no lists.

Lists are an optional feature. You can use Loops without lists but if you'd like finer-grained control over your contacts and the types of communication they receive, lists are available on any plan tier.

Each list you create can be Public or Private.

By default lists are private, meaning they are only shown to their subscribed contacts (non-subscribers won't be able to see or subscribe to private lists in the Preference Center).

If you want to allow general opt-in to a list, you can set the list visibility to 

. Public lists will be shown to all contacts in the Preference Center.

You can also sign up new subscribers to public lists with 

Both private and public lists are visible within your Loops admin and can be used for filtering contacts when sending campaigns and loops.

The Preference Center allows your contacts to manage their own subscription preferences.

A link to the contact-specific Preference Center is automatically added to each marketing email sent from Loops. You can link to the Preference Center in MJML emails by using the 

You can upload a company icon to brand your Preference Center. This option is shown just below your mailing lists in the 

You can brand your unsubscribe page with a company icon even if you do not use the lists features.

Within the Preference Center, contacts will see:

the names and descriptions of all public lists

the names and descriptions of all private lists they are subscribed to

the option to unsubscribe from each list they are subscribed to

![Create a new list](https://mintlify.s3.us-west-1.amazonaws.com/loops/images/mailing-lists/create-list.png)

A new mailing list will appear. Enter a name for your list and optionally, a description.

You can also choose a color to easily identify the list inside your Loops account.


![Visibility toggle](https://mintlify.s3.us-west-1.amazonaws.com/loops/images/mailing-lists/lists-toggle.png) Choose between `Private` or `Public` ([see above](#list-visibility)). Click **Save changes** to finalize the creation of the list.

Edit the name, description, visibility and color.

After saving your changes, the updated list data will be instantly available to your contacts in their Preference Centers.

Here are a few ways you can use lists to send emails and organise contacts.

Trigger a loop when a contact is added to a list

This example is a typical use case of sending an email sequence to new contacts when they are added to a specific list.

[Create a loop](/loop-builder) or edit an existing one. Set the Loop trigger to "Contact added to list". ![Select trigger](https://mintlify.s3.us-west-1.amazonaws.com/loops/images/mailing-lists/set-trigger.png) Select the list you want to trigger the loop. ![Select the list](https://mintlify.s3.us-west-1.amazonaws.com/loops/images/mailing-lists/select-list.png) Start the loop. When a contact is added to the selected list, the loop will be triggered.

Instead of sending campaigns to your whole audience, you can send emails to a specific list.

[Create a campaign](https://app.loops.so/campaigns) or edit an existing one. On the [Audience page](https://app.loops.so/audience), select the list you want to send to.

![Select a mailing list](https://mintlify.s3.us-west-1.amazonaws.com/loops/images/mailing-lists/campaign-list.png)

Users not subscribed to the selected list will not receive the campaign.


Optionally, you can apply additional [filters or segments](/contacts/filters-segments) to further refine your audience.

How to add existing contacts to your different mailing lists within Loops.

You cannot edit the list subscriptions of contacts who have been unsubscribed from your audience. Likewise, if a contact unsubscribes from a list via the Preference Center, they cannot be resubscribed by your team.

Go to your [Audience page](https://app.loops.so/audience).

In the contact details page, click on **Subscribed** to reveal the mailing list dropdown. ![Manage subscriptions](https://mintlify.s3.us-west-1.amazonaws.com/loops/images/mailing-lists/manage-contact-subscriptions.png) Toggle each list on or off as needed. Click **Save changes** in the top right to apply the changes.

You can easily add any filtered group of contacts to a specific list on the Audience page.

Go to your [Audience page](https://app.loops.so/audience). Add filters to segment your audience into the group of contacts you'd like to add to a list. Click the `•••` menu icon on the far right-hand side of the audience filters, select **Add to mailing list** and then select the list(s) you want to add the contacts to. ![Add to list](https://mintlify.s3.us-west-1.amazonaws.com/loops/images/mailing-lists/bulk-assign-to-lists.png)

If you want to import contacts to a list in bulk you can use our 

In the final stage of the form you can select a list, which will add all contacts (new or existing) in the CSV file to that list.

 you can programmatically add and remove contacts to and from Lists.

When creating a contact, updating a contact, or sending in an event with the API, you can include a 

 object is a key-value pair of list IDs and a subscription status. The subscription status can be 

In this example, the contact would be subscribed to 

 (click the ID to add it to your clipboard) or by using the 

 on your website you can subscribe contacts to specific lists.

Adding contacts to a list via a form only works with public lists. The option to select a list will only appear in the form settings if you have at least one public list.

If you already have a form in place or are using a 

 parameter to the form body with the value a comma-separated list of mailing list IDs.

fetch(formEndpointUrl, {
  method: "POST",
  body:
    "mailingLists=cm06f5v0e45nf0ml5754o9cix,cm16k73gq014h0mmj5b6jdi9r" +
    "&email=" + encodeURIComponent(emailInput.value),
  headers: {
    "Content-Type": "application/x-www-form-urlencoded",
  },
});


List management

How to send emails to specific groups of contacts and save segments for future use.

After you have added contacts to your audience in Loops, you may want to send loops or campaigns to certain groups of contacts.

You can do this with filters and segments.

, you can send to specific groups of contacts in your audience.

Choosing these contacts is done using filters, which are based on two sets of data:

 (either default properties or custom properties you've added to your audience)

 from your campaigns and loops (sends, opens and clicks)

For example, you can use filters to build segments like:

contacts with a specific domain in their email address

contacts who were added via a specific source

contacts who were sent a specific campaign

contacts who didn't open a specific email within one of your loops

currently, we can not filter audience to see people who are not in any list.

You can add multiple filters at once, and you can also choose to apply 

Audience filters are automatically updated as contact properties are changed. This means that your emails will only send to contacts that match the filter at the time the email is sent.

Segments are just filters that are saved in your Loops account for the future. This makes them easily re-usable between different loops and campaigns.

You can create segments while sending campaigns or loops, or directly on the [Audience page](https://app.loops.so/audience).

To create a segment, first filter the audience table and then click 

You will be prompted to add a name for your segment, then click 

Your new segment will then be available in a dropdown whenever you filter your audience for campaigns or loops.

Just like filters, segments are automatically updated when contact data is changed, meaning emails always send to the correct contacts at time the email is sent.

Filters and Segments

How to add, edit and delete contact properties.

These are the default properties for every contact on Loops. They cannot be deleted.

"Source" describes where the contact originated from.

By default, this value will be "Form" for contacts added 

. You can specifiy custom "Source" values when adding contacts via forms and the API.

The "Subscribed" value determines whether a contact is able to receive 

Contacts can unsubscribe from your emails using an Unsubscribe link automatically added to your campaigns and loops.

We do not charge for unsubscribed contacts.

We suggest you keep unsubscribed contacts in your audience. If you delete and then re-add them in the future somehow, they may end up being "subscribed" even though they have been unsubscribed.

 or from the Audience page in Loops. You can re-subscribe contacts 

"User Group" is a useful optional property that you can use to segment contacts. It is a free text field that allows you to easily divide contacts into groups like "Users", "VIPs", "Investors" or "Customers".

Contacts can currently only have one user group value.

"User Id" is a unique external ID you can assign to each contact in your audience. For example, this could be a customer ID from your store or a user ID from your SaaS.

This field is optional but is very useful if you are working with our API. For example, you need a user ID to be able to 

Custom contact properties are additional fields that you can create to store information about contacts.

Custom contact properties can be one of four different types:

You can specify a property type when creating new properties in Loops.

Timestamps must be in milliseconds and can be sent as either an integer or string.

Supported date formats are shown below. These must be sent as a string. Adding a time offset at the end (e.g. 

) is optional (if omitted, the date will default to UTC).

Note that Loops does not allow the creation of properties with the following reserved names:

One way to create custom contact properties is to go to 

 and click on any of the column headers, then select 

Alternatively you can scroll to the end of the Audience table and click the 

 button at the end of the column headers.

 page, scroll down to the Contact properties section and click 

In each of these cases, you'll see a form asking you for a property name and type.

POST https://app.loops.so/api/v1/contacts/properties

{
  "name": "myCustomProperty",
  "type": "string"
}


You can delete properties on the Audience page by clicking on column headers.

You can also delete properties from your 

It is not possible to delete default contact properties.

Once a contact property is deleted, all associated data will also be deleted and cannot be recovered. It's important to be sure that you won't need the information stored in a property before deleting it.

If you receive a “Property in use” warning modal while deleting a contact property, there are a few things you can check before you're able to delete the property.

Contact properties

The contact activity timeline is a great way to see all the activity for a specific contact.

The contact activity timeline provides a chronological view of all the activity for a specific contact. To access the contact activity timeline, click on a contact from inside an audience. Email properties that can show on the timeline include:

Additionally, we also show the following properties:

Contact activity timeline

You can delete contacts from your audience on the 

 menu icon on the contact you want to delete and select 

To delete contacts in bulk, use the filters on the 

 to narrow down the selection of contacts you want to delete.

 menu icon in the filter box at the top of the Audience page and select 

This button will delete all contacts listed in the table below, based on the filter(s) you set up.

You can delete single contacts using the API's 

POST https://app.loops.so/api/v1/contacts/delete

{
  "email": "contact123@mail.com"
}


Delete contacts

Stop certain email addresses or domains from being added to your audience.

You can stop certain emails from being added to your audience by using Loops' Email Blocklist feature.

In the input, enter an email pattern to block.

 to block all email addresses ending with 

To block individual email address, simply insert the full address like 

The blocklist feature works across all methods that allow signups to your audience: manually adding in Loops, CSV uploads, forms, the API and all integrations.

Contacts

Contacts articles

List management

Filters and Segments

Contact properties

Contact activity timeline

Delete contacts

Email blocklist