B2B & Wholesale Solution: Configuring Store Display Settings

Store display settings in the B2B & Wholesale Solution app control how customers request quotes and reach your team from your storefront. With these settings, you can let customers submit multi-product inquiries, add inquiry buttons to your product pages and site header, and protect your inquiry forms from bot submissions with Google reCAPTCHA. 

This guide explains how to configure inquiry buttons and forms, set up Google reCAPTCHA, and manage email notifications for new inquiries.

Prerequisites for Configuring Store Display Settings 

Before you begin:

• The B2B & Wholesale Solution app must be installed on your store.
• If your store uses an OS 3.0 theme, add the required app blocks (sample info, MOQ, logistics info, bulk inquiry, product inquiry button, and inquiry button widget) in the Theme Editor. Without these blocks, Store display features won't display correctly on your storefront. For details, see "Integrating Apps into OS 3.0 Themes."

Enabling Multi-Product Inquiry for Quote Lists

To let customers add multiple products to a single inquiry:

1. From your SHOPLINE admin panel, go to Apps > B2B & Wholesale Solution.
2. In the header menu, click Settings > Store display.

3. In the Multi-product inquiry section, turn on the Multi-product inquiry toggle.

   

4. Under Pages where the button appears, click Select pages and choose the pages where you want the Add to quote list button to appear.

   

5. Click Update to save your changes.

When enabled, customers can add multiple products to their inquiry list using the Add to quote list button, then submit one inquiry for all the products in their list.

Showing the Inquiry Button on Your Product List Page

To display an inquiry button on your product list page:

1. On the Store display page, go to the Inquiry button position section.

2. Turn on the Product list inquiry toggle.

   

3. Under Desktop, select where the button appears:
   • Center display on hover: The inquiry button appears centered over the product image when a customer hovers over it. 
   • Below product information: The inquiry button appears below the product's information on the list page.
4. Under Mobile, select how the button displays:
   • Button: Displays the inquiry button as a labeled button.
   • Icon: Displays the inquiry button as an icon. Click Display position for additional icon placement options
5. Click Update to save your changes.

Configuring Floating and Header Inquiry Buttons

The Inquiry buttons section lets you add two types of inquiry buttons to your storefront: a floating button that appears on selected pages, and a header button that appears in your site navigation.

Setting Up the Floating Inquiry Button

To display a floating inquiry button on your storefront:

1. On the Store display page, go to the Inquiry buttons section.

2. Turn on the Floating inquiry button toggle. When enabled, a floating inquiry button appears in the bottom-right corner of the pages you select.

   

3. Under Pages where the button appears, click Select pages, then check the pages where you want the floating button to display.

   

4. Click Update to save your changes.

Setting Up the Header Inquiry Button

To display an inquiry button in your storefront’s top navigation:

1. On the Store display page, go to the Inquiry buttons section.

2. Turn on the Header inquiry button toggle. When enabled, clicking this button on your storefront opens the inquiry form.

   

3. Click Style settings to customize the button’s appearance.

4. In the Style settings panel, configure the following:

   • Button style: Choose one of the three preset button shapes.
   • Button text: Enter the text displayed on the button (for example, "CONTACT US").
   • Button color: Select the button’s background color.
   • Text color: Select the color of the button text.

   

5. Click Update in the Style settings panel to save the button style.
6. Click Update on the Store display page to save your changes.

Managing Inquiry Forms and Where They Display

The B2B & Wholesale Solution app lets you create multiple inquiry forms and choose where each one appears on your storefront. To manage your forms:

1. On the Store display page, go to the Inquiry forms section.

2. Click Create a form to build a new inquiry form, or select an existing form (such as Default Form) to edit it.

   

3. Under Form placement settings, use the drop-down menus in the first Locations table to select which form is displayed for each of the following trigger scenarios:

   

   • Product details/list page: Select the form displayed when customers click the Inquiry button on a product detail or product list page.
   • Bulk Inquiry Page: Select the form displayed on the Bulk Inquiry page after the Multi-product Inquiry feature is enabled.
   • Header inquiry button: Select the form displayed when customers click the Inquiry button in the header of the Inquiry page.
   • Floating inquiry button: Select the form displayed when customers click the Inquiry floating button in the bottom-right corner of the page.

4. To embed a form directly on a page instead, scroll to the second Locations table and click Configure now next to Store home page or Landing page to add the Inquiry Form component. Configure the exact placement in your page design settings.

   Note: For detailed instructions on adding the Inquiry Form component, see "B2B & Wholesale Solution: Placing Form Components on Pages."

   

5. Click Update to save your changes.

Setting Up Google reCAPTCHA to Protect Your Inquiry Forms

To protect your inquiry forms from bot submissions and spam:

1. On the Store display page, go to the reCAPTCHA section.
2. Turn on the Enable reCAPTCHA toggle.

3. Enter the following reCAPTCHA credentials:

   • Site key: Enter the site key generated by Google reCAPTCHA.
   • Secret key: Enter the secret key generated by Google reCAPTCHA.

   If you don’t have these yet, click here to open the Google reCAPTCHA admin console and generate your keys.

   

4. Click Update to save your changes.

Configuring Email Notifications for New Inquiries

To manage who receives email notifications when a customer submits an inquiry:

1. On the Store display page, go to the Email notifications section.

2. Click Staff notification email to set up or edit the email your staff receives when a customer submits an inquiry.

   

3. (Optional) Select the checkbox next to Customer notification email, then click Customer notification email to edit the confirmation email template sent to customers after they submit an inquiry.

   

4. Click Update to save your changes.

Frequently Asked Questions

Q: Why do I see a "Secret key invalid" error, or why does the reCAPTCHA checkbox keep spinning without completing?

Both issues are usually caused by a missing domain entry in your Google reCAPTCHA account. To fix this:

1. Go to the Google reCAPTCHA admin console and open your reCAPTCHA settings.
2. Under Domains, add your store’s storefront domain, then save.
3. Wait a few minutes for the change to take effect, then return to Settings > Store display in B2B & Wholesale Solution and click Update to save your Site key and Secret key again.