Skip to content

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.

The quote widget opened on the storefront: quoted products on the left and the request form on the right

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.

  1. Go to Settings > Quote logic and open a quote logic.
  2. Under the Storefront preview, click Customize.
  3. Open Quote widget. A live preview shows your changes.
  4. 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.

Quote widget section: visibility condition, text content and widget styles

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.

Confirmation after clicking Add to quote: Items added to Quote Request List, with View Quote Request List

By default the widget stays 20px from the bottom right corner of the screen. To move it:

  1. Under Widget position, turn on Set a custom position on desktop.
  2. Choose the Corner: Top left, Top right, Bottom left or Bottom right.
  3. 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.

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.

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.

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.

  1. Open your quote logic and click Customize under the Storefront preview.
  2. Open Quote widget.
  3. Under Quote icon in header, turn on Show quote icon in header.
  4. Set the options below if you need them.
  5. 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.
  • 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 class or id.
  • 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.