> For the complete documentation index, see [llms.txt](https://help.dollarlabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/quotes/quote-emails.md).

# Quote emails

The seven quote emails, who receives each one, and how to edit, test or switch them off.

The app sends quote emails itself. You don't need Shopify Flow or an email app. Find them under **Dollarlabs B2B → Notifications → Quotes**.

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-f79f96d233c04676a545d7750eeef2ee8d179f8b%2Fquotes-notification-emails.png?alt=media" alt="Notifications page, Quotes section: seven emails with To you or To buyer badges, a switch and an Edit button for each"><figcaption><p>Each email has its own switch. All seven are on by default.</p></figcaption></figure>

## Who gets which email

| Email                 | Goes to | Sent when                               | Default subject                                             |
| --------------------- | ------- | --------------------------------------- | ----------------------------------------------------------- |
| **New quote request** | You     | A buyer sends a request                 | New quote request — {items}, {qty} units from {buyer email} |
| **Request received**  | Buyer   | They send a request                     | We received your quote request for {items}                  |
| **New offer**         | Buyer   | You send an offer or counter-offer      | New offer on your quote — {total}                           |
| **Buyer countered**   | You     | The buyer sends a counter-offer         | Buyer countered on {items} — {total}                        |
| **Quote accepted**    | Buyer   | The quote is accepted, by either of you | Your quote for {items} was accepted — {total}               |
| **Quote declined**    | Buyer   | The quote is declined, by either of you | Your quote for {items} was declined                         |
| **Quote expired**     | Buyer   | Your deadline passes                    | Your quote for {items} expired                              |

* **“You”** is your store's contact email in **Shopify Settings → General**. There's no separate address for quote emails.
* The app doesn't send an email when the order is placed. Shopify's order confirmation covers it.

{% hint style="warning" %}
**You aren't emailed when a buyer accepts or declines.** Check **Quotes → Accepted** and **Closed**, or the [overview](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/quotes/respond-to-quotes.md#overview).
{% endhint %}

## Sender and replies

Emails come from `noreply@b2b.notifications.dollarlabs.io`, with your **store name** as the sender name. Replies route automatically: when a buyer replies to their email, it goes to you; when you reply to your copy, it goes to the buyer.

{% hint style="info" %}
**Buyers get quote emails even if they unsubscribed from marketing.** These emails are replies to their own request, so they have no unsubscribe link.
{% endhint %}

Addresses that bounced or reported spam are skipped and listed under **Blocked addresses** on the same page.

## Edit an email

Select **Edit** next to an email.

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-9118846db770eb20988f417887968f6c03c018a2%2Fquotes-email-editor.png?alt=media" alt="Edit New offer: Send this email switch, Subject with Liquid, HTML content and a live desktop preview, with Send test mail and Save buttons"><figcaption><p>Edit the subject and content on the left; the preview on the right uses sample data in your store's currency.</p></figcaption></figure>

* **Send this email** — switch the email off or on.
* **Subject** — Liquid works here too, for example `{{ items_summary }}`, or a condition (see the example below).
* **Email content** — HTML with Liquid. **Desktop** and **Mobile** previews update as you type.
* **Send test mail** — sends the email, with sample data, to your store's contact email. The subject starts with `[Test]`.
* **Save** — saves your version. The email shows a **Customized** badge.
* **Reset to default** — brings back the original. It appears once you've customized an email.

{% hint style="warning" %}
Keep subjects under 300 characters and the content under 20,000 characters.
{% endhint %}

### Variables

| Variable                                                 | What it holds                                                                                  |
| -------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| `{{ shop }}`                                             | Your store's name                                                                              |
| `{{ quote_id }}`                                         | The quote ID, for example `qt_07b624b9-877`                                                    |
| `{{ items_summary }}`                                    | The first product and “+N more”                                                                |
| `{{ qty }}` / `{{ line_count }}`                         | Total units / number of products                                                               |
| `{{ total_display }}` / `{{ total }}` / `{{ currency }}` | The total with currency, the bare number, and the currency code                                |
| `{{ status_label }}`                                     | The quote's status in words, worded for whoever gets the email (see below)                     |
| `{{ status }}` / `{{ version }}`                         | The status as a raw code, such as `MERCHANT_PROPOSAL`, and the version number                  |
| `{{ customer_email }}`                                   | The buyer's email                                                                              |
| `{{ note }}`                                             | The note on the latest version. A buyer's note is cut to 5,000 characters                      |
| `{{ expires_on }}`                                       | The deadline, as a date in your store's time zone                                              |
| `{{ portal_url }}`                                       | The buyer's account (My quotes) — use in buyer emails                                          |
| `{{ admin_quote_url }}`                                  | The quote in the app — use in emails to you                                                    |
| `{{ lines }}`                                            | The lines, each with `title`, `qty`, `unit_price`, `line_total`, `list_price` and `list_total` |
| `{{ form_answers }}`                                     | The request form answers, each with `label` and `value`                                        |

**New quote request** also has the buyer's ask: `{{ asked_total_display }}`, `{{ asked_qty }}` and `{{ asked_unit_price_display }}`.

#### Status words

Use `{{ status_label }}` to show the status in an email. It uses the same words as the app (in emails to you) and the buyer's **My quotes** page (in emails to the buyer), so a buyer never reads “Sent to customer”. `{{ status }}` gives the raw code, which is useful only in Liquid conditions such as `{% if status == "EXPIRED" %}`.

| `{{ status }}`      | `{{ status_label }}` in emails to you | `{{ status_label }}` in emails to the buyer |
| ------------------- | ------------------------------------- | ------------------------------------------- |
| `CUSTOMER_PROPOSAL` | Needs your response                   | Waiting on seller                           |
| `MERCHANT_PROPOSAL` | Sent to customer                      | Your response needed                        |
| `CUSTOMER_ACCEPT`   | Customer accepted                     | Accepted                                    |
| `MERCHANT_ACCEPT`   | You accepted                          | Accepted by seller                          |
| `CUSTOMER_REJECT`   | Customer declined                     | You declined                                |
| `MERCHANT_REJECT`   | You declined                          | Declined by seller                          |
| `EXPIRED`           | Expired                               | Expired                                     |

{% hint style="info" %}
**Long buyer notes are shortened.** The note a buyer types on a request or a counter-offer keeps its first 5,000 characters. The rest is dropped without a warning, in the app and in every email.
{% endhint %}

The editor also has ready-made blocks for the product table, the note, a highlighted box and a button:

```liquid
{% product_table %}
{% note_box %}
{% panel %}Anything in a grey box{% endpanel %}
{% button "Review the offer", portal_url %}

New offer on your quote{% if total_display %} — {{ total_display }}{% endif %}
```

The last line is the default **New offer** subject: it adds the total only when there is one.

### Languages

There's one set of quote emails for all languages. To change the wording buyers see on your storefront per language, see [Translate the wording](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/quotes/storefront-button-and-form.md#translate-the-wording).
