For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

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

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.

A rule group named Paper orders: Product type is Paper, and Customer is logged in: Yes
“Paper orders”: any signed-in customer can ask for a quote on products of type Paper.

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.

Add product types picker with Paper selected
Pick one or more values from your store.
Rule group Trade buyers set to any condition matches, with Customer tag is distributor, wholesale
“Trade buyers”: any customer tagged distributor or wholesale can ask for a quote on every product.

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

Summary panel listing Paper orders and Trade buyers rule groups
The summary updates as you edit. A product is eligible when any group passes.

Quote limits and signed-out shoppers

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
The warning appears when guest requests are on but every rule group needs a signed-in customer.
  • 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.

Quote form editor with Header, five fields including a new Needed by date field, and a live preview
We added a Needed by date field. The preview on the right updates as you edit.
  • Header — the form title, “Request a quote” by default.

  • Add field — the field types from wholesale forms, 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.

Add a field panel with field types grouped as Most used, Choice, Details and Layout
Search or pick a field type.

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.

Request a Quote button page with a Not added badge, an Add to theme button and manual steps
“Not added” means the block isn't on your published theme yet.
  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.

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.

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.

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.

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.

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.

Checkout and accounts editor, Apps panel: under Dollarlabs B2B, the My quotes page is added and shows a check mark
My quotes is listed on its own, below the Credit blocks. The check mark means it's added.

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.

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
Once the page is added and linked, Customize → My quotes page shows Live and “All set”.

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

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.

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, and how to respond to quotes.

Last updated