> 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/storefront-button-and-form.md).

# The storefront: button, quote panel and request form

What buyers see on your storefront — the Request a Quote button, the quote panel and the request form — and how to change the button's look and wording.

## The Request a Quote button

On an eligible product, a buyer who matches your [quote eligibility](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/quotes/set-up-quotes.md#step-1-choose-who-can-request-a-quote) rules sees **Request a Quote** below the buy buttons.

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-73aa58f27b1bb84beab0c6acc00217bc7b025dcd%2Fquotes-storefront-button.png?alt=media" alt="Product page showing the wholesale price, Add to cart, and a Request a Quote button below it" width="580"><figcaption><p>A signed-in trade buyer sees their price, <strong>Add to cart</strong>, and <strong>Request a Quote</strong>.</p></figcaption></figure>

| Who is looking                                                  | What they see                                                                   |
| --------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| Signed in and eligible                                          | **Request a Quote**                                                             |
| Signed in, but the product or customer doesn't match your rules | Nothing                                                                         |
| Signed out, guest requests off                                  | **Log in to request a quote** (or nothing, if you hide it)                      |
| Signed out, guest requests on, product eligible                 | **Request a Quote**                                                             |
| Product already in their quote                                  | **✓ Added to your quote (2)** — the number is how many products the quote holds |

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-586f798f0bde9b6d92406ef0e16bc2d2fdc9325d%2Fquotes-storefront-guest.png?alt=media" alt="Product page for a signed-out visitor, showing the retail price and a Log in to request a quote button" width="580"><figcaption><p>A signed-out visitor sees <strong>Log in to request a quote</strong>. It takes them to sign in and back to the product.</p></figcaption></figure>

The button adds the variant selected on the page, in the quantity shown in your theme's quantity box.

{% hint style="info" %}
**Sold-out products can still be quoted.** Check stock before you accept a large quote.
{% endhint %}

## The quote panel

Clicking the button adds the product to the buyer's quote, much like adding to a cart. A panel opens in the corner: **Your quote**, with each product, its regular price, a quantity box and **×** to remove it.

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-1ab966f70c592f1c58f2c1995cad1fa18736cae8%2Fquotes-storefront-panel.png?alt=media" alt="Your quote panel with Kraft Envelopes and Cotton Drawing Paper, quantity controls and a Review and send request button" width="606"><figcaption><p>The quote is saved in the buyer's browser as they shop.</p></figcaption></figure>

The quote is saved as they browse, so a buyer can add products from several pages and send one request. With the [Quote widget](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/quotes/set-up-quotes.md#the-quote-widget-app-embed) app embed on, the panel follows them across your store. A quote holds up to 50 products.

## The request form

**Review & send request** opens the form in two steps.

**1 · Items** — a quantity and an optional **Target price** for each product. The line shows the total and how far below the regular price the buyer is asking. **Your ask** adds up the lines that have a target price. A product without a target price is a request for you to price it.

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-f54fd9af37bc39ec6f349341781d497041d0fe81%2Fquotes-request-form-items.png?alt=media" alt="Request a quote form, Items step: 500 Kraft Envelopes at a target price of 1.10, 45% off list, and 200 Cotton Drawing Paper with no target price" width="725"><figcaption><p>The buyer names a price for the envelopes and leaves the paper for you to price.</p></figcaption></figure>

**2 · Your details** — the fields from your [quote form](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/quotes/set-up-quotes.md#step-2-adjust-the-request-form).

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-20d645664df01224c70af39aca05d9788e05efd3%2Fquotes-request-form-details.png?alt=media" alt="Your details step with name, email, phone, a note and a Needed by date, and a Send request button" width="725"><figcaption><p>Name and email are filled in for signed-in buyers.</p></figcaption></figure>

**Send request** sends it. The buyer sees “Your quote request was sent. Track it under My quotes in your account.” and the panel empties. Both of you get an email; see [Quote emails](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/quotes/quote-emails.md).

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-f1df114a5bda48ae60db509e2a0c7a6af380e411%2Fquotes-storefront-request-sent.png?alt=media" alt="Product page with a confirmation message: Your quote request was sent. Track it under My quotes in your account." width="606"><figcaption><p>The confirmation appears in the corner of the page.</p></figcaption></figure>

If something stops the request, the buyer sees why — for example, they've reached your open-quote limit, a target price has more than two decimal places, or a product is no longer eligible.

{% hint style="info" %}
**“List” and “off list” mean the product's regular Shopify price.** A buyer whose price list gives them $1.80 still sees $2.00 in the panel and form, and their target is measured against $2.00. Volume tiers, case quantities and price-list columns are not applied to quotes; you set the final prices in your offer.
{% endhint %}

### Currency

The quote uses the currency of the market the buyer is shopping in, if your store sells in that currency; otherwise your store's currency.

{% hint style="warning" %}
**Switching market clears target prices.** If the buyer changes market while building a quote, the target prices they typed are cleared and they're asked to enter them again.
{% endhint %}

## Button settings

Open **Dollarlabs B2B → Customize → Request a Quote button**. The live preview on the right shows the button, the “added” state, the signed-out button and the confirmation.

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-b6fef3edfb3e8c60b333f20d0d3e0a15ca9cc410%2Fquotes-button-settings.png?alt=media" alt="Button settings: background and text colours, Hide the button entirely when logged out, Replace Add to Cart with Request a Quote, and a live preview"><figcaption><p>The button also takes its height, corner radius and font from your theme's own buy button.</p></figcaption></figure>

| Setting                                      | What it does                                                                                                                                                                                           |
| -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Background** / **Text**                    | Button colours, as six-digit hex codes. Default: `#1A1A1A` on `#FFFFFF`.                                                                                                                               |
| **Hide the button entirely when logged out** | Shows nothing to signed-out visitors instead of **Log in to request a quote**. Use it when another block on the page already asks buyers to sign in. Ignored when guest requests are allowed.          |
| **Replace Add to Cart with Request a Quote** | Hides **Add to cart** and **Buy it now** on eligible products, for buyers who can request a quote — useful for “call for price” products. Off by default, so buyers can still buy at the listed price. |
| **Buttons to hide (CSS selectors)**          | Appears when the setting above is on. The defaults cover most themes; add your theme's selector if **Add to cart** still shows.                                                                        |
| **Text & languages**                         | Change any wording on the button, panel and form, per language.                                                                                                                                        |
| **Custom CSS**                               | Extra styles, added after the button's own. Target `.dl-rfq__btn`.                                                                                                                                     |

### Translate the wording

Every word buyers see — the button, the panel, the form and its messages — can be changed under **Text & languages**. Add each of your store's published languages there. Translate the form's title and questions under **Quotes → Quote form → Translations**. To add a language to your store, use **Shopify Settings → Languages**.

{% hint style="info" %}
**Quote emails have one version for all languages.** See [Quote emails](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/quotes/quote-emails.md).
{% endhint %}
