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.
1. Overview
Section titled “1. Overview”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)
2. Product Information
Section titled “2. Product Information”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 Detail Fields
Section titled “Product Detail Fields”- 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.
3. Form Fields
Section titled “3. Form Fields”This section controls the fields that the customer completes before submitting a quote.

3.1 Standard Information Fields
Section titled “3.1 Standard Information Fields”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.
3.3 Tax Number Format Validation
Section titled “3.3 Tax Number Format Validation”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.
3.4 Purchase Order (PO) Number
Section titled “3.4 Purchase Order (PO) Number”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.
3.5 Company Information (Shopify B2B)
Section titled “3.5 Company Information (Shopify B2B)”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.


Click the edit icon of a built-in section, change the Label, then click Save
3.6 Custom Fields
Section titled “3.6 Custom Fields”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), orcrm.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=newsletterand comes back later from an ad withutm_source=adsandutm_medium=cpc, the quote hasnewsletterforutm_sourceandcpcforutm_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
notefield 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.
3.8 Layout Elements & Field Management
Section titled “3.8 Layout Elements & Field Management”- 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.
3.9 Billing address as the main address
Section titled “3.9 Billing address as the main address”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.

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.


Both addresses are saved on the quote. You can still edit them in the admin, see View and edit a quote.
4. Form Styles
Section titled “4. Form Styles”Customize the look and feel to match your storefront branding:

General Layout
Section titled “General Layout”- Border width: Outline thickness of the form modal.
- Border radius: Corner rounding of the form container.
Color Scheme
Section titled “Color Scheme”- 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.
Quantity Rule
Section titled “Quantity Rule”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.
5. Preview States
Section titled “5. Preview States”Switch between two preview states at the top of the editor:

- Quote Form: The live submission form shown to storefront buyers.
- After Submit: The confirmation modal and thank-you message shown post-submission.
6. Multi-Language Storefront Translations
Section titled “6. Multi-Language Storefront Translations”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.
7. Advanced Custom Styling (CSS & JS)
Section titled “7. Advanced Custom Styling (CSS & JS)”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 ondocument.head, so they do cross the shadow DOM boundary and work with standardaddEventListenercode.
8. Keyboard accessibility
Section titled “8. Keyboard accessibility”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.
Turn it off or on
Section titled “Turn it off or on”You can change this without help from us. It is a setting of the B2B Portal app embed.
- In Shopify admin, go to Online Store > Themes and click Customize on your live theme.
- Open App embeds (the puzzle icon in the left sidebar) and click B2B Portal.
- Tick or untick Keyboard accessibility for the quote form.
- 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.
- Customize quote widgetSet when the floating quote widget shows, where it sits and how it looks, so buyers can open their quote list and submit a quote request from any page.
- Set up prices and buttonsHide prices and buying buttons for quoted products, and choose where the quote button shows and how it looks, for each quote logic.
- Set up quote visibilitySet who can request a quote and which products can be quoted, with exclusions, priority and status for each quote logic.
- Quote settingsA reference for every card on the Settings page of the quote engine: what each setting does, its default, the plan it needs and where to read more about it.