Skip to content

Quick Start (5–10 mins setup)

Get BSS B2B Quote up and running on your storefront in a few minutes. You create a quote logic, check the Request a Quote button on your store, send yourself a test quote and look at the emails your buyers get.

The app guides you in two places:

  • First-run setup: opens the first time you open the app, in four steps (Your needs, Quick setup, Plan, Demo). A label at the top shows where you are, for example Step 2 of 4.
  • Setup guide on Home: Let’s get your first quote button live. It keeps track of what is left and checks each step off when you finish it.
  1. Your needs: choose what you want to start with: Request a quote, Quick order, Reorder or Something else. If you choose Something else, describe what you need. We send your note to our team and they reply in chat. The setup then goes straight to the Demo step.
  2. Quick setup: for Request a quote, you pick a template and who sees the quote button, the app creates your first quote logic, you turn on the app embed, and you preview the quote button on your store and send a test quote.
  3. Plan: choose a plan to show the quote button to your buyers. The app suggests a plan for what you built. Click Start free trial & go live. On a development store, click Activate free dev plan. You can also click Stay in preview for now and go live later from Home.
  4. Demo: book a demo with our team, or click Finish.

Your progress is saved after each step. If you close the app or reload the page, the setup opens at the step you left.

The app embed and preview parts of Quick setup have a skip button (for example I’ll do it later or Skip test). Before you skip, the app tells you what happens. For example, if you skip the app embed, your preview does not show the button until you turn the embed on. If you skip the plan, buyers do not see the quote button until you choose a plan. When it is shown, Skip setup at the bottom of a step, next to Back, lets you leave the setup and finish everything later from Home.

On Home, the setup guide has four steps, and the app checks them off as you finish them:

  1. Choose where the quote button shows: create a quote logic.
  2. Turn on the app embed.
  3. Check the quote button on your store.
  4. Send a test quote.

If your store has no plan yet (preview mode), a fifth step, Go live, asks you to choose a plan. Create a Quick Order page is an optional line at the end and does not count toward the progress.

The steps below follow the same order.

Home: the setup guide Let’s get your first quote button live, with the steps still to do, the plan notice and the storefront check line

The setup guide on Home

Home: the Needs your attention card with quotes that are overdue, and the storefront check line showing Nothing to fix

The Needs your attention card on Home


  1. A quote logic decides who sees the quote button, on which products, and what happens to the price and Add to cart. You need at least one active quote logic to show the Request a Quote button.

    1. On Home, click Create quote logic in the setup guide. You can also go to Settings > Quote logic and click Create quote logic.
    2. If you are in the first-run setup, pick a template instead: Quote for all products, Hide price + quote (hides the price, Add to cart and Buy now, so buyers request a quote) or Quote from cart (a button on the cart page). Then choose Who sees the quote button?: Everyone, Logged-in customers or B2B companies, and click Create quote button.

    Settings > Quote logic: the list of quote logics with Create quote logic at the top right

    In the logic editor, a Storefront preview shows the result on the right. At the top of Quote visibility, choose the Customer type:

    • Default customers (selected by default)
    • Company customers (B2B customers, needs the Enterprise plan of BSS B2B Quote; on other plans it is greyed out with an upgrade link)

    The customer type can’t be changed after the quote logic is saved.

    Add new logic: Customer type at the top of Quote visibility with the Default customers and Company customers cards, General information below, and the Storefront preview on the right

    Under Quote visibility, enter a name, set the Status, (optional) set a Priority (0 to 99, 0 is the highest), choose who can request a quote, and exclude customers if needed. Under Quote catalogs, choose which products can be quoted.

    Quote logic page: Preview on store at the top, Quote visibility with name, status, priority and Who can request a quote, and the Storefront preview with Product page, Collection page and Quote form tabs on the right

    Click Save to apply the quote logic to your store.


  2. The app embed loads the quote button and form on your storefront. Without it, nothing from the app shows.

    1. On Home, in the setup guide, click Open theme editor next to Turn on the app embed.
    2. The app opens the Shopify theme editor on the app embeds.
    3. Turn the B2B Portal app embed ON in the left sidebar and click Save in the top-right corner. If the theme editor also lists Quote Engine storefront, you can turn it on too, but keep B2B Portal on. See Install and enable app embeds.
    4. Return to the app. It checks your live theme and checks off the step.

    Theme editor, App embeds: the B2B Portal and Quote Engine storefront embeds of BSS B2B Quotes, both switched on

    Turn on the B2B Portal app embed and click Save

    The status line under the setup guide on Home shows Nothing to fix and your Live theme once the embed is on. Click Run again to check again.

    Home: the storefront check footer showing Nothing to fix and the live theme, with Run again

    If another app already uses the app proxy path /apps/customer-portal, Home shows App proxy doesn’t reach this app with a Check URL button, because quote requests from your storefront may not reach you. Click Check URL to open the Proxy URL steps. See Check the App Proxy URL.

    Home: App proxy doesn’t reach this app, with the Check URL button


  3. Open your store and look at the button as your buyers see it.

    1. On the quote logic page, click Preview on store. On Home, click Preview on a product in the setup guide. Your store opens in a new tab on a page the logic covers, so you can see the quote button.
    2. If you don’t see it, click Don’t see the quote button? for a short checklist (app embed, theme, plan, customer, inactive quote logic). In the setup guide, Check this page runs the same check on your live theme and checks off the step when the app embed and the button pass.
    3. To change the look of the button, the widget or the form, click Customize under the Storefront preview. The Customize quote button and form modal shows your changes in a preview. See Customize the quote form and Customize the quote widget.
    4. If the button shows but sits in the wrong place, see Button placement and themes.

    Product page on the storefront with the Add to quote button above Add to cart

    Customize quote button and form modal: the icon menu on the left, the Quote Button settings with Display quote button on and Button styles, and a preview of the product page


  4. You can see your quote button and send a test quote before you choose a plan.

    1. Click Preview on my store (in the first-run setup) or Preview on store (on the quote logic page or in the setup guide). Your store opens in a new tab.
    2. A banner at the top of the page shows that you are in preview. Click Exit preview to leave the preview. The page reloads without the app.
    3. Add a product to the quote list and submit the quote form. This is the Send a test quote step of the setup guide. Your test quote shows up in Quotes.

    Request For Quote form: quoted products on the left, customer information on the right, then Submit Request

    About the preview link:

    • It is valid for 24 hours. After that, open Preview on store again.
    • It works only in the browser where you opened it. Buyers and other browsers see nothing from the app until you go live. On a store without a plan, only the browser that opened the preview link sees the app.
    • If your online store has a password, enter the storefront password first, then open the preview. You need the password only once in the same browser.
    • The theme editor preview is for looking only. To send a test quote, use Preview on my store (first-run setup) or Preview on store (quote logic page and setup guide).

    About test quotes:

    • Test quotes show a Test badge in Quotes.
    • The email to you has [TEST] at the start of the subject. Your buyer gets no email.
    • Test quotes are not counted in Insights or in the Home statistics.
    • A store without a plan can send 5 test quotes in 24 hours, and 10 in total.
    • If the quote form is for logged-in customers, such as company customers, log in to your store as that kind of customer first.

  5. Quote emails are what your buyers read first: the proposal, the reminders and the approve or reject buttons.

    1. No time to use your store? In the first-run setup, click Send me a sample quote email to get a sample at your store email. It needs a store email in your Shopify settings.
    2. Open your test quote in Quotes to see the quote page, where you edit prices and send the proposal.
    3. Edit the wording and the PDF of the emails, and set reminders. See Quote emails and reminders.
    4. If you want emails to come from your own domain, see Sender and deliverability.

  6. If your store has no plan yet, buyers see nothing until you choose one.

    • On Home, click Choose a plan next to Go live, then start your free trial. On a development store, click Activate free dev plan.
    • Compare the plans in Pricing Plan & Details.

Quick Order and Reorder are extra ordering tools for your buyers. If you want them, see the Quick Order Full Setup Guide and the Reorder Full Setup Guide.