Customize quote widget
The floating quote widget gives buyers a way to open their quote list from any page, like a cart icon for quotes. This page shows how to choose when it shows, where it sits and how it looks. It is part of each quote logic, in the Quote widget section of Customize quote button and form.

What your buyers see on the storefront.
Before you start: create a quote logic and turn on the app embed in your live theme. See Quote logic and Install and enable app embeds.
Open the Quote widget section
Section titled “Open the Quote widget section”- Go to Settings > Quote logic and open a quote logic.
- Under the Storefront preview, click Customize.
- Open Quote widget. A live preview shows your changes.
- Click Done, then save the quote logic.
The section has Widget settings, Widget position and Widget styles, and the header icon described at the end of this page.

Widget settings
Section titled “Widget settings”Under Visibility condition, choose when the widget shows:
| Visibility condition | What happens |
|---|---|
| Always show quote widget | The widget is always on the screen, even when the quote list is empty. This encourages buyers to start a quote. |
| Show quote widget only when customers add at least one item to quote | The widget stays hidden until the buyer adds a product to the quote. Then it appears so they can finish the request. |
| Do not show quote widget | The widget is hidden. Buyers open the quote form from the View Quote Request List link in the message that shows after they add a product. |
Under Text content, enter a short label for the widget, for example “Request quote” or “My quote list”. To translate the label, see Languages.
The widget also shows a small number bubble with the number of items (total quantity) in the quote list. It shows 99+ above 99. It updates by itself and has no setting.

Widget position
Section titled “Widget position”By default the widget stays 20px from the bottom right corner of the screen. To move it:
- Under Widget position, turn on Set a custom position on desktop.
- Choose the Corner: Top left, Top right, Bottom left or Bottom right.
- Set Distance from the side edge and Distance from the top or bottom edge, from 0 to 200.
For small screens, you have two options:
- Set a separate position on mobile (screens up to 749px wide): choose a corner and distances just for phones.
- Hide the widget on mobile: the widget does not show on screens up to 749px wide.
Widget styles
Section titled “Widget styles”Under Widget styles, set the shape and colors so the widget fits your store:
- Border width: from 0 to 20.
- Corner radius: from 0 to 100. A higher value makes the widget rounder.
- Colors: Background color, Text color, Border color.
- Hover colors, for when a mouse moves over the widget: Hover background color, Hover text color, Hover border color.
What buyers see
Section titled “What buyers see”Buyers who match the quote logic see the widget on every page, as you set it. They click it to review the products in their quote list and send the request.
Quote icon in the header
Section titled “Quote icon in the header”Show a quote icon with an item count next to the cart icon in your theme header. Buyers click it to open the quote form. It works on any theme, including Dawn and Horizon. You do not add a block to your theme.
Turn it on
Section titled “Turn it on”- Open your quote logic and click Customize under the Storefront preview.
- Open Quote widget.
- Under Quote icon in header, turn on Show quote icon in header.
- Set the options below if you need them.
- Save the quote logic, then reload your storefront.
When the option is off, the app loads nothing for the icon.
| Option | What it does |
|---|---|
| Accessibility label | The name that screen readers read for the icon. Up to 40 characters. |
| CSS selector of the spot | The theme element the icon goes next to. Leave empty to use the cart icon (Dawn, Horizon and similar themes). Up to 300 characters. |
| Position next to that spot | Before or After the element. |
| Corner when no spot is found | The corner where the icon floats if your theme has no spot for it. |
| Icon size | From 16 to 40 px. |
| Badge color, Badge text color | Colors of the item count bubble. |
If the icon is in the wrong place
Section titled “If the icon is in the wrong place”- Enter the CSS selector of the element you want the icon next to, and choose Before or After. To find a selector, right-click the element on your storefront, choose Inspect, and copy its
classorid. - If the app finds no spot, the icon floats in the corner you chose. It floats only when the widget is not set to Always show quote widget. With Always show, the widget is the entry point and the floating icon stays hidden.
- The icon is not shown to a buyer who matches no quote logic.
Theme developers can build their own header icon with the Storefront Events and API.
Related
Section titled “Related”- Customize Quote FormChoose the product details and form fields on the quote form, style the form, and set the message customers see after they submit.
- 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.