> 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/set-up-quotes.md).

# Set up quotes

Choose who can request a quote, adjust the request form, and add the quote button, quote panel and My quotes page to your store.

Open **Dollarlabs B2B → Quotes** and select **Start setup**. A step bar at the top of the page takes you through the three steps. **Save & continue** saves the step you're on; **Back** returns to the last one.

## Step 1: Choose who can request a quote

**Quote eligibility** decides which products show the **Request a Quote** button, and to whom.

{% hint style="warning" %}
**No rule groups means no button.** Until you save at least one rule group, no product is quote-eligible and buyers don't see the button. For the simplest setup, select **Quote every product for logged-in customers**.
{% endhint %}

### Rule groups

A rule group is a set of conditions with a name. **A product shows the button when any rule group passes.**

Each group has two parts, and the app checks them separately:

| Part                 | Fields you can use                                                        | If you leave it empty   |
| -------------------- | ------------------------------------------------------------------------- | ----------------------- |
| **Which products?**  | Product tag, Product collection, Product vendor, Product type, Product ID | Every product qualifies |
| **Which customers?** | Customer tag, Customer company, Customer is logged in                     | Every visitor qualifies |

A group with no conditions in either part never passes.

**A group passes when its product part and its customer part both pass.** Inside each part, **Passes when** decides how the conditions combine:

* **all conditions match** — every condition in that part must be true
* **any condition matches** — one true condition in that part is enough

```mermaid
flowchart LR
    product{"Which products?<br/>passes"} -->|"Yes"| customer{"Which customers?<br/>passes"}
    product -->|"No"| no["Group doesn't pass"]
    customer -->|"Yes"| yes["Group passes:<br/>button shows"]
    customer -->|"No"| no
```

For example, a group set to **any condition matches** with “Product type is Paper” and “Customer is logged in: Yes” lets signed-in customers quote paper products only. It doesn't open every product to every signed-in customer. When both parts have conditions, the editor reminds you: “Needs one matching product condition and one matching customer condition.”

Operators are **is**, **is not** and **contains**. Collection, product ID and company use **is** and **is not**; **Customer is logged in** is **Yes** or **No**. Matching ignores upper and lower case.

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-424b1085da71edc7a0d5c91985c73b0bd50b00dc%2Fquotes-eligibility-rule-group.png?alt=media" alt="A rule group named Paper orders: Product type is Paper, and Customer is logged in: Yes" width="617"><figcaption><p>“Paper orders”: any signed-in customer can ask for a quote on products of type Paper.</p></figcaption></figure>

Select **Add product tags**, **Add collections** or a similar button to pick values. Tags, vendors, types and companies come from your store; products and collections open Shopify's own picker.

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-627db7ce8773dddfb018069065c53d3538095d01%2Fquotes-eligibility-value-picker.png?alt=media" alt="Add product types picker with Paper selected" width="640"><figcaption><p>Pick one or more values from your store.</p></figcaption></figure>

{% hint style="danger" %}
**Several values in one condition count as separate conditions.** “Customer tag is distributor, wholesale” in a group set to **all conditions match** means the customer needs **both** tags. To let in customers with **either** tag, set **Passes when** to **any condition matches**, or make one rule group per tag. The app blocks the save only for fields that can hold one value (such as product type); for tags it can't tell, so check this yourself.
{% endhint %}

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-ded2c5b33f612d8e73baccd9b9266c4e5395bebe%2Fquotes-eligibility-any-condition.png?alt=media" alt="Rule group Trade buyers set to any condition matches, with Customer tag is distributor, wholesale" width="577"><figcaption><p>“Trade buyers”: any customer tagged <code>distributor</code> or <code>wholesale</code> can ask for a quote on every product.</p></figcaption></figure>

The **Summary** beside the editor restates your rules as you edit them.

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-f298d4a79a25933c1999e369a03be3191a92d85e%2Fquotes-eligibility-summary.png?alt=media" alt="Summary panel listing Paper orders and Trade buyers rule groups" width="400"><figcaption><p>The summary updates as you edit. A product is eligible when any group passes.</p></figcaption></figure>

### Quote limits and signed-out shoppers

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-f3f32aa2facf8b53d4ff01f2b39a1d9477863c99%2Fquotes-eligibility-limits-guests.png?alt=media" alt="Quote limits: Max open quotes per customer set to 3, and the Logged-out shoppers choice with a warning that no rule lets a guest through" width="592"><figcaption><p>The warning appears when guest requests are on but every rule group needs a signed-in customer.</p></figcaption></figure>

* **Max open quotes per customer** — default 3, minimum 1. A quote is open while it waits on you or on the buyer. A buyer at the limit sees a message asking them to add products to an open quote or wait for a reply. One quote can hold many products, so most buyers need only one.
* **Logged-out shoppers**
  * **Send them to log in first** (default) — signed-out visitors see **Log in to request a quote** on eligible products.
  * **Let them request a quote with their email** — guests can send a request without an account. The app creates a Shopify customer from their email and tags it `rfq-guest-lead`, so the lead isn't lost. If the email already belongs to a customer account, the guest is asked to log in instead.

Your product rules apply either way. If a rule group needs a customer tag, a company or a signed-in customer, guests can't match it — the page warns you when that's the case.

Save with **Save** in the bar at the top. Changes usually reach your storefront within a minute.

## Step 2: Adjust the request form

**Quote form** is what buyers fill in when they send a request. The default form is ready to use:

| Field                                                       | Required |
| ----------------------------------------------------------- | -------- |
| Name                                                        | Yes      |
| Email                                                       | Yes      |
| Phone                                                       | No       |
| Note — “Anything we should know? (target price, timeline…)” | No       |

Signed-in buyers find their name and email filled in.

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-771c6411b64ead9a20e28b975938eb22031092d3%2Fquotes-form-builder.png?alt=media" alt="Quote form editor with Header, five fields including a new Needed by date field, and a live preview"><figcaption><p>We added a <strong>Needed by</strong> date field. The preview on the right updates as you edit.</p></figcaption></figure>

* **Header** — the form title, “Request a quote” by default.
* **Add field** — the field types from [wholesale forms](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/wholesale-forms/build-your-form.md#field-types), except **File upload**, **Consent**, **First name** and **Last name**. Quote requests can't carry attachments, and the built-in **Name** field already fills in for signed-in buyers. Each field has a label, placeholder, help text and a **Required** setting.
* **Translations** (top of the page) — translate the form title and each question into your store's languages.

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-a74d127ecb3bee21094f7fcd8c1d06c0bf9ef4ab%2Fquotes-form-field-types.png?alt=media" alt="Add a field panel with field types grouped as Most used, Choice, Details and Layout" width="560"><figcaption><p>Search or pick a field type.</p></figcaption></figure>

{% hint style="success" %}
**Quantities and target prices are built in.** Each product in the request already has them, so you don't need form fields for them.
{% endhint %}

## Step 3: Add the quote button to your theme

Your storefront needs two pieces from the app in your theme. Buyers also need the **My quotes** page in their customer account.

### The Request a Quote app block

Open **Customize → Request a Quote button** in the app (or select **Next** from step 2). The page shows whether the block is on your **published** theme.

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-ccccdfa0af0efac956157e04fddbfc90921187df%2Fquotes-button-not-added.png?alt=media" alt="Request a Quote button page with a Not added badge, an Add to theme button and manual steps"><figcaption><p>“Not added” means the block isn't on your published theme yet.</p></figcaption></figure>

1. Select **Add to theme**. The theme editor opens on a product page with the block ready to place.
2. Put it in the **Product information** section, beside the buy buttons.
3. Select **Save** in the theme editor.

To add it yourself: **Online Store → Themes → Customize**, switch the page picker to a **Product** page, open **Product information**, select **Add block**, and choose **Request a Quote** under **Apps**.

{% hint style="info" %}
**Can't find Request a Quote or Quote widget in the theme editor?** They're listed only when your plan includes Quotes (available on the Founding plan). After you change plan, they appear shortly afterwards.
{% endhint %}

{% hint style="info" %}
The app checks your **published** theme. If you add the block while previewing another theme, that theme gets it; the page shows “Not added” until you publish it.
{% endhint %}

{% hint style="info" %}
**The theme editor always shows the block.** If the product or the preview customer doesn't match your rules, it adds “Preview only” — real buyers won't see the button there.
{% endhint %}

### The Quote widget app embed

Turn on **Quote widget** once under **Online Store → Themes → Customize → App embeds**. It keeps the buyer's quote-in-progress in a small panel on every page, so they can keep browsing and send the request from anywhere. Without it, the panel appears only on product pages that have the block.

### The My quotes page in customer accounts

Buyers read and answer your offers on **My quotes**. It isn't a block inside another page — it's a whole page of its own in the buyer's Shopify customer account. Setting it up takes two parts: add the page in the accounts editor, then link it from the account menu.

{% hint style="danger" %}
**Both parts are required.** Until the page is added and linked, **My quotes** doesn't open for buyers (“There's a problem loading this page”), so they can't accept, counter or pay — even from the links in their emails.
{% endhint %}

#### Part 1: Add the page in the accounts editor

1. In Shopify admin, go to **Settings → Customer accounts**.
2. Under **Configurations**, select **Customize**. The checkout and accounts editor opens.
3. Select the **Apps** icon in the editor's left toolbar.
4. Under **Dollarlabs B2B**, find **My quotes** and select **⊕** to add it. A check mark shows it's added, and **My quotes** appears in the page picker at the top of the editor.
5. Select **Save**.

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-f502e9a9cc49a122db43d2c89a13dd66b7bb0a3d%2Fquotes-accounts-editor-my-quotes.png?alt=media" alt="Checkout and accounts editor, Apps panel: under Dollarlabs B2B, the My quotes page is added and shows a check mark" width="280"><figcaption><p><strong>My quotes</strong> is listed on its own, below the Credit blocks. The check mark means it's added.</p></figcaption></figure>

#### Part 2: Link the page in the customer account menu

The quickest way is from the accounts editor, right after Part 1:

1. In the editor's notice, select **Add to menu**. Shopify opens the customer account menu your buyers see, with a new item already linked to **My quotes**.
2. Type a label, such as `My quotes`.
3. Select **Save**.

To do it from the menu list instead:

1. In Shopify admin, go to **Content → Menus**.
2. Open your customer account menu. It is called **Customer account main menu**, or **Store default: Customer account main menu**.
3. Select **Add menu item**, type a label, then in the **Link** field open **Apps** and pick **My quotes**.
4. Select **Save**.

{% hint style="warning" %}
**Do you see both menus in Content → Menus?** Buyers see only one of them. Use **Add to menu** in the accounts editor: it always opens the menu your buyers see.
{% endhint %}

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-8a3cd9dee6b56734a50e8351373024492cfc5140%2Fquotes-my-quotes-page-live.png?alt=media" alt="My quotes page screen in the app with a Live badge and an All set — good to go banner: We found My quotes in your menus"><figcaption><p>Once the page is added and linked, <strong>Customize → My quotes page</strong> shows <strong>Live</strong> and “All set”.</p></figcaption></figure>

The app's **My quotes page** screen shows **Live** a few seconds after you save.

{% hint style="warning" %}
**Can't find Content → Menus, the Apps option or the accounts editor?** Your store uses legacy customer accounts. Switch to the current customer accounts under **Settings → Customer accounts**.
{% endhint %}

{% hint style="info" %}
After an app update, Shopify may ask you to approve access to **Online Store pages** and **Online Store navigation**. The app uses these to find the My quotes link in your menus. Select **Update** to continue.
{% endhint %}

## Check before you launch

1. Sign in as a test customer who matches one of your rule groups. Open an eligible product: **Request a Quote** appears.
2. Open a product that doesn't match: no button.
3. Sign out: you see **Log in to request a quote**, or nothing if you turned on **Hide the button entirely when logged out**.
4. Send a test request. Check the **Request received** email, the **New quote request** email in your store's contact inbox, and the request under **Quotes → Quotes**.
5. Send an offer, then open **My quotes** from the test customer's account menu. The offer shows with **Accept offer**, **Counter-offer** and **Decline this quote**.

Next: [what buyers see on the storefront](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/quotes/storefront-button-and-form.md), and how to [respond to quotes](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/quotes/respond-to-quotes.md).
