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

# Referral Notifications and Emails

> Cello provides notifications that are seamlessly integrated with your product experience to inform, activate and continuously engage users with the referral program

Cello provides notifications that are seamlessly integrated with your product experience to inform, activate and continuously engage users with the referral program. This page provides details on the notifications types and how to customize based on your needs.

## Notifications types and triggers

Notifications the we support fall into 2 categories: **in-product** announcement and alert and **external** like email. These notifications and their associated triggers are designed to work in conjunction your existing product engagement touch points in a seamless way.

### Alert and Badge

**Alert** is a notification that appears under Rewards tab. It is accompanied with a **badge**.

<img src="https://uploads.developerhub.io/prod/d316/wzufn8xw627p0mvthxp48une8gwby82c718mfxr1jb3zy2g83jonavodouyj5x3h.png" alt="New reward alert" />

A **badge** is a small colored dot displayed on the launcher opening the widget (Cello button or [Custom Launcher](/referral-component/custom-launcher)) to draw attention to the activity with the referral program without being too distracting from your core product experience.

<img src="https://uploads.developerhub.io/prod/d316/fe2vyoz0ncewwupgi0oyrhzmjhf5xhthd8w82enr6ke8lcem0tqz710rs6eixdlb.png" alt="Badge examples with Cello Button and Cello Custom Launcher" />

| Type                            | Description                                                                                                                     |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| "New referrer activation" alert | Displayed after referrer has used the product more then 1 day after signs up to bring subtle attention to the referral program. |
| "Successful share" alert        | Displayed every time referrer has a new link view.                                                                              |
| "New reward" alert              | Displayed every time the referrer receives a new signup or reward.                                                              |

### Announcement

Announcements are callout style message that appears anchored to the launcher, either Cello button or [Custom Launcher](/referral-component/custom-launcher). Announcements can be dismissed by clicking on them or their "X" dismiss button.

<img src="https://uploads.developerhub.io/prod/d316/zrkmyalf4bqkeap8lqpeo5rjfmfo0tei9aiotdeosqb12znuft2ezcasd3d1xta5.png" alt="Announcement examples anchored Cello Button or Cello Custom Launcher" />

| Type                                   | Description                                                                                                       |
| -------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| "New referrer activation" announcement | Sent 3 days after a ["New referrer activation" alert](#alert-and-badge) is sent and the user has not acted on it. |
| "New reward" announcement              | Sent if the user has not entered their payment details after 7 days of receiving the first reward.                |

### Email

Emails are a way to keep your users aware and engage with the referral program without them needing to log into the application. By default, Cello will send emails about the key events in the referral lifecycle.

<img src="https://mintcdn.com/cello/exsJfd7wvZFYUJmJ/images/Cello-email-templates-welcome-email-successful-share-new-reward.png?fit=max&auto=format&n=exsJfd7wvZFYUJmJ&q=85&s=cac9a84ad74b070e62e55756eda1eb9d" alt="Standard email template examples" width="1207" height="814" data-path="images/Cello-email-templates-welcome-email-successful-share-new-reward.png" />

<Info>
  Don't forget to add user email to the [boot command of the Referral component](/sdk/client-side/cello-js#3-initialize-the-library) to start sending emails to your users.
</Info>

| Type                                                                 | Description                                                                                                                                                 |
| -------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| "Welcome" email <span className="badge-green">+10% activation</span> | By default is sent on the 6th day after new referrer first signs up to introduce the referral program and its details.                                      |
| "Successful share" email                                             | Sent once when the referrer gets a first successful share, i.e. someone has viewed their link, to keep the momentum and encourage more sharing.             |
| "New reward" email                                                   | Sent every time the referrer receives a new reward. When referrer gets a first monetary reward this email contains information on how to claim the rewards. |
| "Unclaimed rewards" email                                            | Sent if the user has not entered their payment details after 7 days of receiving the first reward.                                                          |

## Default notification journey

Below is an illustration of the default new referrer's journey with key milestones and how Cello uses different types of notifications to keep them informed and engaged.

<img src="https://uploads.developerhub.io/prod/d316/at41hnhzvn4nytinw2emmltsrdimxnm2tcnrpmnjbeyp6n8nhtkyhp85b4ww0gub.png" alt="Default notification journey" />

## Activation campaign

In addition to the default notification journey, you can run **an activation campaign** with Cello to activate users for your referral program with recurring announcements.

<img src="https://uploads.developerhub.io/prod/d316/5w3a355er95x3bpwl0zojtks25pfkv1g3j92iq0a9d1k2wqzvlc8pvjluwe0exyy.png" alt="Default activation campaign sequence" />

**How it works:**

1. Activation campaign starts 30 days after ["New referrer activation" announcement](#announcement) is sent and the user has not acted on it.
2. The recurring announcements will be only send if the user full-fills a certain activity pattern in the product like:

* Referrer has used the app at least once after reading the last announcement.
* Last activation announcement was read.
* Referrer didn't share in the last 30 days.

## Notification settings

You can preview and configure which notifications you want Cello to send in your [Cello Portal](https://portal.cello.so/setup/notifications).

<img src="https://uploads.developerhub.io/prod/d316/ggs0vibypp72j23retxz0c1ulfms994igbbt398l7f53j7mmjw6ewcfmvw04ucng.png" alt="Cello Portal notifications settings" />

Cello distinguishes between **Essential** and **Engagement** notifications. Essential notifications are **always on** as they are required for the program to run successfully. You can choose to turn off Engagement notifications, however, they do give a significant performance improvement.

## Email template customization

You can customize the look and feel of your email templates directly in the [Cello Portal](https://portal.cello.so/setup/notifications). Open any email notification row to bring up the preview panel - editable elements are highlighted on hover.

<img src="https://mintcdn.com/cello/exsJfd7wvZFYUJmJ/images/cello-email-upload-logo-change-cta-upload-presentation-image.png?fit=max&auto=format&n=exsJfd7wvZFYUJmJ&q=85&s=dbd25fb1cfc0cdddae904739d564595d" alt="Email template customization in Cello Portal" width="1440" height="1372" data-path="images/cello-email-upload-logo-change-cta-upload-presentation-image.png" />

<Info>
  Customizations apply to **all email types** at once. You can open any individual email preview to see how your changes look across different templates.
</Info>

### Customizable options

| Option             | Description                                                                                                               |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------- |
| Logo               | Upload your company logo. Hover over the logo in the preview and click to replace it.                                     |
| Presentation image | Upload a hero image displayed prominently in the email body. Hover over the image in the preview and click to replace it. |
| CTA link           | Set the URL for the main call-to-action button. Hover over the button in the preview and click to edit.                   |

The **Welcome email** has one additional option: a **second CTA link**, letting you direct new users to a specific page alongside the referral program link.

### How to customize

1. Go to **Notifications** in the [Cello Portal](https://portal.cello.so/setup/notifications).
2. Click any email notification row to open its preview panel.
3. Hover over the logo, image, or CTA button - a prompt will appear to click and edit.

Changes are applied across all email templates automatically.
