Skip to content

Customize Quote Form

This page explains how to control the content, form fields, and appearance of the quote form that customers see when they request a quote on your storefront.


The Form Fields and Form Styles sections of your Quote Logic (click Customize under the Storefront preview of the logic page) let you configure:

  • Which product and customer information appear in the quote pop-up
  • Which form fields customers must fill in before submitting
  • Automated field verifications (such as VAT / Tax Number format checking and live Shipping Method calculations)
  • The look and feel of the form so it matches your store branding
  • A quantity rule (minimum, maximum and increment) for every product in the form

You also have a real-time live preview of:

  • The Quote Form (before submission)
  • The After Submit state (confirmation state shown after sending a quote)

Product details shown in the quote form are set per Quote Catalog (section Quote Catalogs of the logic page), not in the form settings. See the Full Setup Guide. The options below control which product details and item-level inputs are displayed inside the quote pop-up.

  • Product information: Variant, SKU, Available quantity, Price (hidden when the catalog hides prices).
  • Advanced information (Growth plan or higher): Vendor, Barcode, Type, Offer price, Note.

Item Note Box (Note per Item) (Growth plan or higher)

Section titled “Item Note Box (Note per Item) (Growth plan or higher)”
  • Note Box per Product Item: Enable a dedicated text area under each product item on the RFQ form (up to 500 characters, optional).
  • Item-Specific Notes: Each item possesses an independent note box mapped directly to that product (e.g., specific customization instructions, cutting dimensions, packaging requirements).
  • Traceability: Notes display across all downstream touchpoints: Quote Details in Admin, Admin Notification Email, Quote Proposal Email, Quote Confirmation Email, Quote PDF Template, and Storefront Quote History.

This section controls the fields that the customer completes before submitting a quote.

Form Fields section: the list of form fields with edit, hide and delete icons, and the Live Preview of the Request For Quote form below

Default customer fields include:

  • First Name & Last Name
  • Email & Phone Number
  • Shipping Address (Country, Street, City, State, ZIP)

Behavior: If the customer is logged in, these fields can be auto-filled using their Shopify customer profile.

3.2 Shipping Method Selection (Plan Business+)

Section titled “3.2 Shipping Method Selection (Plan Business+)”

Allow B2B buyers to select their preferred shipping method directly when submitting their quote request:

  • Live Rate Calculation: The dropdown retrieves real-time shipping methods and rates directly from your store’s active Shopify Shipping Zones based on the buyer’s shipping address.
  • Configuration: Set the field to Required or Optional.
  • Storefront language: rate names follow the storefront language the buyer is browsing, using the shipping rate translations you added in Translate & Adapt. Rates without a translation, and rates from carrier apps, keep their original name. The admin, admin PDFs and draft orders always show the original name. The app needs the translation access you approve when you open it after the 16 October 2026 update.
  • Seamless Proposal Integration: When the merchant opens Manage Quote, the selected shipping method is pre-selected and its cost is automatically calculated into the proposal total without manual re-entry.

Collect and validate tax identification numbers from corporate buyers before approving wholesale quotes:

  • Format Validation: Client-side regex checking validates submitted numbers against international tax formats (e.g., EU VAT, UK VAT, US EIN, Australia ABN).
  • Configuration: Toggle field on/off, set as Required or Optional, customize label text, and select which validation patterns to apply.
  • Data Storage: Submitted tax numbers are saved alongside the quote request and recorded in customer notes for admin inspection.

Allow corporate buyers to enter an internal Purchase Order (PO) Number:

  • Links quote requests directly with the buyer’s internal ERP or accounting purchase order.
  • Displays across CMS Quote Details, Storefront Quote History, Proposal Emails, and PDF Quotes.
  • Only one PO Number field is allowed per form.

If you selected “B2B Store” as your store type, the form automatically displays synced Shopify B2B Company Information:

  • Company Name
  • Location
  • Default Company Shipping Address

The Customer Information and Company Information sections are built in: you can’t hide, remove or change their fields, but you can click the edit icon to rename the section heading. The heading applies to this quote logic only.

Form Fields of a Company Customers logic: Customer Information, Company Information and Additional Information, each with edit, hide and delete icons, and the Live Preview showing the section headings

Edit Field Customer Information: the Label box with Cancel and Save

Click the edit icon of a built-in section, change the Label, then click Save

Create tailored fields to collect specific information for your business:

  • Single Line Text & Paragraph: For short notes, project titles, or detailed specifications.
  • Number: For target budget figures or estimated order quantities.
  • Email: For alternative accounting or purchasing contact emails.
  • Dropdown & Radio Buttons: For industry classification, buyer tier, or delivery preferences.
  • Checkbox List: For multi-option accessories or add-on requests.
  • File Upload: Allow buyers to attach PDFs, technical drawings, or spec sheets.

3.7 Hidden Fields (UTM and other tracking values)

Section titled “3.7 Hidden Fields (UTM and other tracking values)”

A Hidden field collects a value without showing anything to the buyer, for example where the buyer came from. Use it to keep UTM parameters or an ID from your CRM with the quote. Add it like any custom field and set:

  • Label: the name shown next to the value in the quote note, admin and emails. Buyers do not see this field on the form, but its label and value are added to the quote note, which buyers can read in Quote History, the proposal email and the PDF.
  • Value comes from: URL parameter or JavaScript variable.
  • Parameter or variable name: for example utm_source (URL parameter), or crm.leadId (JavaScript variable). Up to 100 characters.

When the value is read

  • URL parameter: the value from the buyer’s first visit is kept for 30 days, also when the buyer moves to other pages of your store (or your theme removes the parameter from the address, for example when a variant is selected). When the buyer opens the quote form, the form uses the kept value. If nothing was kept, it uses the parameter in the address at that moment, and if there is none the field stays empty.
  • JavaScript variable: read from the page at the moment the buyer opens the quote form. It is not kept between pages, so the variable must exist on the page where the form is opened.

How the first visit is kept

  • Each parameter is kept on its own. If a buyer first arrives with utm_source=newsletter and comes back later from an ad with utm_source=ads and utm_medium=cpc, the quote has newsletter for utm_source and cpc for utm_medium.
  • A new visit does not replace a kept value for 30 days. After that, the next visit with the parameter is kept instead.
  • The kept value is not deleted when the buyer sends a quote, so a second quote from the same browser has the same source.
  • Only parameters that you set in a Hidden field are kept, and only on pages where the app is active (the app embed is on and a quote logic applies to the buyer). Add the field before your campaign starts: visits before that are not remembered.
  • The value is kept in the buyer’s browser. If the browser blocks storage (for example some private modes), the form uses the parameter in the address when the form is opened.
  • Values are plain text, up to 500 characters.

Where the value appears

  • The Notes card of the quote in the app, as Label: value.
  • The draft order note.
  • The {{quote_note}} variable of emails and PDF templates.
  • The note field of the quote in the Public API.

A field without a value is left out of the note. A hidden field you hide with the eye icon is left out of the note as well.

  • Heading & Divider: Add visual section titles and dividing lines to organize long forms.
  • Show/Hide Toggle: Toggle field visibility with the eye icon.
  • Address section: In the Address section editor, the Country/Region and Province/State sub-fields each have their own Visible checkbox, so you can hide them when you only sell and ship in one country. Hidden sub-fields are not shown to buyers and are not required on submit. You can translate their label and placeholder in Storefront Translation.
  • Edit: Customize label text, placeholder text, and required/optional status.
  • Drag-and-Drop Reorder: Reorder fields to create a natural submission flow.

By default the address section of the form is the shipping address. If your customers think of their address as a billing address (common for B2B buyers in the UK and EU), turn on Ask for a billing address for the Quote Logic. It is a checkbox in the form setup panel (Form styles), below Show subtotal and total, and it is off by default.

Form styles panel with the Ask for a billing address checkbox ticked, below Show subtotal and total

When it is on, buyers who are not Shopify B2B company customers see this on the quote form:

  • The address section is titled Billing Address (if you renamed that section, your name stays).
  • A checkbox Add a different shipping address sits under it.
  • If the buyer does not tick the checkbox, the shipping address of the quote is the same as the billing address. Shipping methods and rates, tax, and the draft order use that address, so the buyer does not fill in the address twice.
  • If the buyer ticks the checkbox, a second address section titled Shipping Address opens with the same fields. The shipping methods and rates then follow that shipping address.

Quote form on the storefront: the address section is titled Billing Address, with Country/Region and Province/State fields

Quote form on the storefront: Add a different shipping address ticked, with a Shipping Address section below

Both addresses are saved on the quote. You can still edit them in the admin, see View and edit a quote.


Customize the look and feel to match your storefront branding:

Form Styles section: text size, border width, corner radius and color scheme

  • Border width: Outline thickness of the form modal.
  • Border radius: Corner rounding of the form container.
  • General: Background color, text colors, and scrollbar styling.
  • Form Header: Background and title text colors.
  • Primary Button: Normal and hover states for main CTA (e.g. “Submit Request”).
  • Secondary Button: Buttons such as “Continue Shopping” or “Back”.
  • Input Fields / Boxes: Background, border, and placeholder text colors.

Set one quantity rule for the quote form of this Quote Logic, so customers can only request quantities that fit your minimum, maximum and step. It is in the form setup panel, below the color settings.

  • Apply a quantity rule to the quote form: turn it on to show the fields below. When it is off, the form behaves as before (minimum 1, step 1).
  • Minimum: the lowest quantity of each product. Whole number, 1 or more.
  • Maximum: the highest quantity of each product. Leave it empty for no limit. It can’t be lower than the minimum.
  • Increment: the step between allowed quantities. Whole number, 1 or more (default 1). Allowed quantities start at the minimum: with minimum 5 and increment 6, the customer can request 5, 11, 17 and so on.
  • Replace Shopify quantity rules: some products (for Shopify B2B customers) have a quantity rule set in Shopify. When this is off, those products keep their Shopify rule and your rule applies to all other products. When it is on, your rule applies to every product in the form.

The same rule applies to every product line in the form of this logic. If two Quote Logics have different rules, a customer gets the rule of the logic that matches them.

What customers see (example: minimum 6, maximum 60, increment 6):

  • The + and − buttons move 6 → 12 → 18, and stop at 6 and 60.
  • If a customer types a quantity that doesn’t fit and leaves the box, it rounds up to the next allowed quantity: 7 becomes 12. A quantity above the maximum becomes the highest allowed quantity, 60 in this example.
  • If a line still has a quantity that doesn’t fit (for example one set by your theme), Submit is blocked and a message under that line explains the rule. The customer fixes the quantity and submits again. No pop-up is shown.
  • The quote is checked again when it is created, so a request that breaks the rule is refused and no quote is created.

Switch between two preview states at the top of the editor:

Live Preview on After submit: Quote Request Sent Successfully, the quote ID and Back To Store

  1. Quote Form: The live submission form shown to storefront buyers.
  2. After Submit: The confirmation modal and thank-you message shown post-submission.

If your store sells to buyers across multiple countries using Shopify Markets, you can customize all form labels, field titles, placeholders, and error messages for each active language:

  • Navigate to Settings → Languages → Request for Quote to manage copy per locale (e.g. English, German, French).
  • The storefront automatically detects buyer language and renders the corresponding translation.
  • You can also translate each form field’s label, placeholder and options per language. See Form fields in Quote Form translations.
  • For complete setup details, see the Storefront Translation Guide.

For bespoke theme requirements that exceed standard color picker controls:

  • Custom CSS: The quote modal renders inside a shadow DOM, so your theme’s regular CSS (including custom CSS files) cannot reach its internals — only the button that opens the modal lives outside the shadow boundary and can be styled normally. Use the built-in Style Setting color and typography controls for the modal itself; there is no supported way to override its internal styles from theme CSS.
  • Custom JavaScript: You can listen for storefront quote lifecycle events (such as quote modal open, item added, and quote submitted) to trigger custom third-party tracking or interactive behavior. These are real browser CustomEvents dispatched on document.head, so they do cross the shadow DOM boundary and work with standard addEventListener code.

Customers who use a keyboard or a screen reader can work with the quote pop-up. This is on by default for every store. You do not change your form or your quote logic.

What the pop-up does when it is on

  • Escape closes the pop-up. While the form is sending, Escape does nothing.
  • Tab and Shift + Tab move between the fields and buttons of the pop-up only. Focus does not leave it for the page behind.
  • When the pop-up opens, focus moves into it (to the close button). When it closes, focus goes back to the button that opened it.
  • A screen reader announces the pop-up as a dialog, with its title.
  • If a field has an error, the error text is read out and tied to that field.

The look of the form does not change.

Where it applies

It applies to the quote form that opens as a pop-up (from the quote button or the quote widget). The full page layout of the quote form is a normal page, not a pop-up, so it has no Escape and no focus trap.

You can change this without help from us. It is a setting of the B2B Portal app embed.

  1. In Shopify admin, go to Online Store > Themes and click Customize on your live theme.
  2. Open App embeds (the puzzle icon in the left sidebar) and click B2B Portal.
  3. Tick or untick Keyboard accessibility for the quote form.
  4. Click Save.

When it is off, the pop-up works as it did before: Escape does not close it, Tab can leave it, and it is not announced as a dialog.

The setting is saved per theme. If you publish a different theme, check it again in the new theme. If you turn it off because it clashes with your theme, contact support so we can look at it.