> 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.md).

# Quotes

Let buyers request a quote from your storefront, then price it, negotiate and turn the agreed price into a Shopify draft order.

**Quotes lets a buyer ask you for a price instead of buying at the listed one.** They add products to a quote from your product pages, say how many they need and what they hope to pay, and send the request. You answer with an offer in the app. When one of you accepts, the agreed prices go onto a Shopify draft order that the buyer can pay.

Use it for large or custom orders, products you don't price publicly, and buyers who expect to negotiate.

{% hint style="info" %}
**Plan:** Quotes is available on the Founding plan.
{% endhint %}

If your plan doesn't include Quotes, **Quotes** in the app opens an upgrade page with **View plans**, and the **Request a Quote** block and **Quote widget** embed aren't listed in your theme editor. Development stores have Quotes switched on so you can test before you go live.

## How a quote moves

```mermaid
flowchart TD
    request["Buyer sends a quote request"] --> you(["Your turn<br/>Needs your response"])
    you -->|"Counter-offer"| buyer(["Buyer's turn<br/>Sent to customer"])
    buyer -->|"Counter-offer"| you
    you -->|"Accept"| accepted["Accepted"]
    buyer -->|"Accept"| accepted
    you -->|"Decline"| declined["Declined"]
    buyer -->|"Decline"| declined
    buyer -.->|"Your deadline passes"| expired["Expired"]
    accepted --> pay["Buyer pays the draft order"] --> order["Shopify order"]
```

Each offer is saved as a new **version**, so you and the buyer can see the whole negotiation. Either side can accept while it's their turn. A declined or expired quote is closed for good; the buyer can start a new one.

A Shopify **draft order** is created as soon as the buyer sends a request, tagged `rfq` and `rfq:<quote id>`. It's updated with every offer and deleted if the quote is declined or expires. [Respond to quotes](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/quotes/respond-to-quotes.md#draft-orders-and-payment) explains how it becomes an order.

## Set it up

Quotes has a three-step setup in the app. Open **Dollarlabs B2B → Quotes → Start setup**.

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-dd22b410fdd8ab22593533aeff1358b38f534931%2Fquotes-overview-first-run.png?alt=media" alt="Quotes overview before setup, with a Set up quotes in 3 steps card and a Start setup button"><figcaption><p>Before setup, the Quotes overview shows only the setup card.</p></figcaption></figure>

1. [Choose who can request a quote](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/quotes/set-up-quotes.md#step-1-choose-who-can-request-a-quote) — rule groups for products and customers, the open-quote limit, and whether signed-out shoppers can ask.
2. [Adjust the request form](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/quotes/set-up-quotes.md#step-2-adjust-the-request-form) — the default form works as it is.
3. [Add the button to your theme](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/quotes/set-up-quotes.md#step-3-add-the-quote-button-to-your-theme) — the **Request a Quote** app block, the **Quote widget** app embed, and the **My quotes** page, which you add in the accounts editor and link from the customer account menu. Without both, buyers can't open **My quotes**.

## Everything in this section

* [Set up quotes](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/quotes/set-up-quotes.md) — the three setup steps in detail
* [The storefront: button, quote panel and request form](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/quotes/storefront-button-and-form.md) — what buyers see, and the button's settings and wording
* [What buyers see after they send a request](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/quotes/buyer-experience.md) — emails and the **My quotes** page in their account
* [Respond to quotes](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/quotes/respond-to-quotes.md) — the inbox, offers, deadlines, draft orders and the customer-page block
* [Quote emails](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/quotes/quote-emails.md) — the seven emails, who gets them, and how to edit them
* [Quotes FAQ & troubleshooting](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/quotes/quotes-faq.md)
* [Quotes API](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/developer-tools/quotes-api.md) — read quotes from your own systems

## Before you start

* **Customer accounts.** Buyers answer your offers on the **My quotes** page in Shopify's customer accounts (the current version, not legacy accounts). Check **Shopify Settings → Customer accounts**.
* **Quote prices are separate from your price list.** A quote starts from the product's regular Shopify price. Volume tiers, case quantities and price-list columns are not applied to quotes. You set the final price in your offer. See [How quote prices work](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/quotes/respond-to-quotes.md#how-quote-prices-work).
